AdsGetCollation

Advantage Client Engine

Gets the collation language setting of a connection.

Syntax

UNSIGNED32

AdsGetCollation( ADSHANDLE hConnect,

UNSIGNED8 *pucCollation,

UNSIGNED16 *pusLen );

Parameters

hConnect (I)

A connection handle.

pucCollation (O)

The collation language of the connection, or an empty string.

pusLen (I/O)

Length of given buffer on input, length of returned data on output.

Remarks

AdsGetCollation returns the collation language set on a connection. Initially, a connection has no collation set on it and AdsGetCollation will return an empty string. AdsSetCollation can be used to set the collation language. See AdsSetCollation for a description of when the collation language of a connection is used.

Example

usLen = sizeof( aucCollation );

ulRetCode = AdsGetCollation( hConnect, aucCollation, &usLen );

See Also

AdsSetCollation

AdsStmtSetTableCollation

AdsGetTableCollation

AdsGetIndexCollation

Dynamic Collation Support.