AdsStmtSetTableRights

Advantage Client Engine

Sets the rights checking mode used by the statement

Syntax

UNSIGNED32

AdsStmtSetTableRights( ADSHANDLE hStatement,

UNSIGNED16 usCheckRights )

Parameters

hStatement (I)

Handle of an SQL statement created by a call to AdsCreateSQLStatement.

usCheckRights (I)

Indicates if the server is to use rights checking for the file open. Options are ADS_CHECKRIGHTS and ADS_IGNORERIGHTS. If ADS_CHECKRIGHTS is given, then the Advantage Database Server will use the rights of the connected user when creating the file, and if the user does not have rights to the directory or server, then the creation will fail. If ADS_IGNORERIGHTS is used, then the Advantage Database Server will ignore the connected user's rights and create the table regardless. This way an application developer can allow only Advantage-based applications to access specific data.

Remarks

The default value for newly created statement handles is ADS_CHECKRIGHTS.

Note An open cursor cannot be associated with the statement when this API is called. If an open cursor exists close it using AdsCloseTable before calling this API.

Example

Click Here

See Also

AdsGetTableOpenOptions

AdsStmtSetTableCharType

AdsStmtSetTableLockType

AdsStmtSetTableReadOnly

AdsStmtSetTableType