Advantage Client Engine
Adds a key built on the current record to the custom index order.
Syntax
UNSIGNED32 |
AdsAddCustomKey (ADSHANDLE hIndex); |
hIndex (I) |
Handle of index order that was created with the ADS_CUSTOM option. |
Custom indexes are empty when created and require keys to be explicitly added and removed. AdsAddCustomKey will add a key based on the current record to the custom index order. This key will be updated if the values in the record change.
Custom indexes can only be built on tables opened with the ADS_CDX or ADS_ADT option.
Note When the index is shared, adding a custom key will fail if the record is locked by another application. If the index is opened exclusively, custom keys can be added even when the record is locked by another application. To open an index exclusively, open the table exclusively or open the table in shared mode and create a custom index without closing it.