Advantage Client Engine
Retrieves logical value from the given field.
UNSIGNED32 |
AdsGetLogical (ADSHANDLE hTable, UNSIGNED8 *pucFldName, UNSIGNED16 *pbValue); |
hTable (I) |
Handle of table or cursor. |
pucFldName (I) |
Name of field to retrieve. |
pbValue (O) |
Return the value. |
AE_NO_CURRENT_RECORD |
Data cannot be retrieved from EOF or BOF |
The value returned in pbValue will be either True (1) or False (0). AdsGetLogical also returns False if the logical field contains a NULL value. To determine if a False return type is NULL or assigned to False, call AdsIsEmpty or AdsGetString on the logical field.
The pucFldName parameter can be passed as the field name itself or as the one-based integer field position. To pass an integer field position for the pucFldName parameter, use the ADSFIELD macro that is defined in ACE.H. For example, to specify the first field in the table, pass ADSFIELD(1) for the pucFldName parameter; to specify the second field in the table, pass ADSFIELD(2) for the pucFldName parameter; etc.