JagGetInstanceData  JagGetPeerAddress

Chapter 5: C Routines Reference

JagGetPassword

Description

Retrieve the password for the client connection that is associated with a C or C++ component instance.

Syntax

JagStatus JAG_PUBLIC JagGetPassword(
          SQLPOINTER password, 
          SQLINTEGER passwordLen,
          SQLINTEGER *returnLen)

Parameters

password

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.

passwordLen

The length, in bytes, of the password array. The length must include space for a null-terminator.

returnLen

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.

Returns

Return value

To indicate

JAG_SUCCEED

Success

JAG_FAIL

Failure

JagGetPassword fails for the following reasons:

Check the server’s log file for more information when JagGetPassword fails.

See also

JagGetHostName, JagGetUserName





Copyright © 2005. Sybase Inc. All rights reserved. JagGetPeerAddress