Retrieve the password for the client connection that is associated with a C or C++ component instance.
JagStatus JAG_PUBLIC JagGetPassword( SQLPOINTER password, SQLINTEGER passwordLen, SQLINTEGER *returnLen)
The address of a character array to receive the client password. If the connection has a NULL password, JagGetPassword writes a null-terminator to the password buffer.
The length, in bytes, of the password array. The length must include space for a null-terminator.
NULL or the address of a SQLINTEGER variable.
returnLen is an optional output parameter that receives the length, in bytes, of the password value. The host name is null-terminated and the length includes the null-terminator.
Return value |
To indicate |
|---|---|
JAG_SUCCEED |
Success |
JAG_FAIL |
Failure |
JagGetPassword fails for the following reasons:
password was NULL.
The buffer length is insufficient.
The routine was called in code that was not executing in the context of a component method call.
Check the server’s log file for more information when JagGetPassword fails.
