|
Parameter
|
Type
|
Description
|
|
IN
|
||
|
hRowElem
|
DAM_HROWELEM
|
The value set handle.
|
|
iXoType
|
int
|
The data type in which to get the value. The data can be supplied in a format that corresponds to the column's definition in the schema or in any other format and the OpenAccess SDK SQL engine will perform the required conversion.
|
|
OUT
|
||
|
ppVal
|
void **
|
The pointer to the data is returned in this location. The C type of the data corresponds to the iXoType value. See Table 33. Use this pointer only if the *piValLen is not set to XO_NULL_DATA. Do not attempt to free this data.
|
|
piValLen
|
int *
|
Length of the data pointed to by *ppVal:
 XO_NULL_DATA - null data
XO_NTS - null terminated string
>= 0 - length of the data
Note: The function dam_addValToRow uses long to specify the data length. This discrepancy will be fixed in future releases.
|
|
RETURN
|
||
|
int
|
Status of the function call:
DAM_SUCCESS - all data retrieved.
DAM_SUCCESS_WITH_RESULT_PENDING - more data is available and should be retrieved by calling this function again. This occurs for a large LONGVARBINARY data.
DAM_FAILURE - error in getting the data. Most likely the data cannot be converted to the XO_Type asked for.
|