dbsetlpwd

Sets the user Microsoft® SQL Server™ password in the LOGINREC structure.

Syntax

RETCODE DBSETLPWD (
PLOGINREC loginrec,
LPCSTR password );

Arguments

loginrec

Is a pointer to a LOGINREC structure, which is passed as a parameter to dbopen. To get one of these pointers, call dblogin.

password

Is the SQL Server password that is sent to SQL Server. It must be a null-terminated character string. The maximum length of the string is 30 characters, not including the null-terminating character.

Returns

SUCCEED or FAIL.

Remarks

For DBSETLPWD to have any effect, call it before dbopen.

You do not need to call it if the password is a null value.

See Also