Advantage Client Engine
Retrieves the number of links active on the current connection.
UNSIGNED32 AdsGetNumActiveLinks( ADSHANDLE hDBConn,
UNSIGNED16 *pusNumLinks );
hDBConn (I) |
Handle of a database connection. |
pusNumLinks (O) |
Returns the number of links that are active on the current connection. |
This function is used to retrieve the number of active links on the current connection. A global link that is stored in the data dictionary is not active until it is used in an SQL statement on the current connection.
The execution of the following SQL statement creates an implicit link to the ARCHIVE database so the AdsGetNumActiveLinks should return 1 in the output.
AdsConnect60( "n:\\MyData\\MASTER.ADD", ADS_REMOTE_SERVER, "User1",
"password", ADS_DEFAULT, &hDBConn );
AdsCreateSQLStatement( hDBConn, &hStmt );
AdsExecuteSQLDirect( hStmt, "SELECT Max(LastDate) FROM \"n:\\MyData\\ARCHIVE\\ARCHIVE.ADD\".Table1",
&hCursor );
// usNumLinks should be 1
AdsGetNumActiveLinks( hDBConn, &usNumLinks );