AdsSetCollation

Advantage Client Engine

Sets the collation language on a connection.

Syntax

UNSIGNED32

AdsSetCollation( ADSHANDLE hConnect,

UNSIGNED8 *pucCollation );

Parameters

hConnect (I)

A connection handle.

pucCollation (I)

The collation language to be set. See dynamic collation support.

Remarks

AdsSetCollation sets the collation language for a specific connection handle. The collation language of a connection is used when ACE APIs which take a collation language (AdsOpenTable90, AdsCreateTable90, AdsDDAddTable90, and AdsRestructureTable90) are called without a collation language. It is also used with SQL statement handles which have not had a collation language set on them using AdsStmtSetTableCollation.

Note Collation languages passed to ACE APIs are only valid with ADS_ADT or ADS_VFP tables. The AdsSetCollation API will not affect ADS_NTX and ADS_CDX tables.

Example

ulRetCode = AdsSetCollation( hConnect, "GERMAN_VFP_CI_AS_1252" );

See Also

AdsGetCollation

AdsStmtSetTableCollation

AdsGetTableCollation

AdsGetIndexCollation

Dynamic Collation Support.