Advantage Client Engine
Removes either a local link or a global link from current connection.
UNSIGNED32 AdsDDDropLink( ADSHANDLE hDBConn,
UNSIGNED8 *pucLinkedDD,
UNSIGNED16 usDropGlobal );
hDBConn (I) |
Handle of a database connection. |
pucLinkedDD (I) |
The name or path of the link to drop. If the path is given, the first link matching the given path will be dropped. |
usDropGlobal (I) |
True to remove the global link alias from the data dictionary. If this parameter is True, the pucLinkedDD parameter must specify the link alias in the data dictionary. |
AE_INVALID_OBJECT_NAME |
This error may be returned if the usDropGlobal parameter is True and the specified link cannot be found in the data dictionary. |
This function can be used to either drop an active link from the current connection or remove a global link from the data dictionary. Since the database server maintains information on the active links, dropping active links from the current connection will free some resources consumed by the server.
DROP permissions on the link are required to drop a link from the data dictionary. See Advantage Data Dictionary User Permissions for more information.
Note This function can be called inside a transaction, but will not be part of the transaction. Any changes it makes cannot be rolled back.
The execution of the following SQL statement creates an implicit link to the ARCHIVE database. The implicit link is then dropped.
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 );
AdsDDDropLink( hDBConn, "n:\\MyData\\ARCHIVE\\ARCHIVE.ADD", FALSE );