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 timeout |
| 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.
BCP_SETL, dbfreelogin, dbopen, DBSETLAPP, DBSETLHOST, DBSETLNATLANG, DBSETLPACKET, DBSETLPWD, DBSETLSECURE, DBSETLTIME, DBSETLUSER, DBSETLVERSION