Allocates a LOGINREC structure for use in dbopen.
PLOGINREC dblogin ( void );
A pointer to a LOGINREC structure. NULL is returned if the structure cannot be allocated.
DB-Library contains various functions that supply components of the LOGINREC.
| Function | Component supplied |
|---|---|
| DBSTLUSER | Login ID. |
| DBSETLPWD | Password. |
| DBSETLHOST | Workstation name. |
| DBSETLAPP | Application name. |
| DBSETLNATLANG | National language. |
| DBSETLPACKET | TDS packet size. |
| DBSETLSECURE | Secure connection request. |
| DBSETLTIME | Connection-specific time-out. |
| DBSETLVERSION | DB-Library 6.0 behavior. |
| BCP_SETL | Enables bulk copy operations. |
Generally, it is necessary for the program to supply only the username and password. All components in the LOGINREC are initially set to NULL.