Advantage Client Engine
Calculates a 32-bit CRC value using the current record.
UNSIGNED32 |
AdsGetRecordCRC (ADSHANDLE hObj, UNSIGNED32 *pulCRC, UNSIGNED32 ulOptions) |
hObj (I) |
Handle of a table or cursor. |
pulCRC (O) |
Pointer to a 32-bit unsigned integer that will hold the CRC value. |
ulOptions (I) |
Options. |
AdsGetRecordCRC calculates a 32-bit CRC value using the current record data, including all memo and blob data.
Two options flags are supported and can be passed in the ulOptions parameter:
ADS_DEFAULT
ADS_CRC_LOCALLY
If the ADS_CRC_LOCALLY option is passed, the CRC will be calculated on the client. If the record contains memo and/or blob data, this data will be read over to the client in order to calculate the CRC value. If there is a substantial amount of memo/blob data this operation can be time consuming.
If the ADS_DEFAULT option is passed, the API will make a decision on whether to calculate the CRC locally, or to send a server request to calculate the CRC. If the table does not contain any memos or blobs, the CRC will be calculated locally, which can increase performance.