AdsGetConnectionProperty

Advantage Client Engine

Returns data about an active connection.

Syntax

UNSIGNED32

AdsGetConnectionProperty( ADSHANDLE hConnect,

UNSIGNED16 usPropertyID,

VOID *pvProperty,

UNSIGNED32 *pulPropertyLen );

Parameters

hConnect (I)

Connection handle

usPropertyID (I)

Constant identifying what property to retrieve

pvProperty (O)

Pointer to a buffer to return the result in

pulPropertyLen (I/O)

On input, the size of the buffer pointed to by pvProperty. On output, the length of data returned in pvProperty.

Remarks

The following values can be passed in the usPropertyID parameter:

ADS_CONNECTIONPROP_USERNAME

If this property ID is passed in, a null-terminated string representation of the username will be placed in the pvProperty buffer. If the connection is a free connection (as opposed to a database connection), an empty string will be returned.

ADS_CONNECTIONPROP_PASSWORD

If this property ID is passed in, a null-terminated string representation of the password will be placed in the pvProperty buffer. If the connection is a free connection (as opposed to a database connection), an empty string will be returned.