sqlgdref API - Dereference an address

Copies data from a buffer that is defined by a pointer, into a variable that is directly accessible by the application. This API is used in host programming languages, FORTRAN and COBOL, which do not provide pointer manipulation. This API can be used to obtain results from APIs that return a pointer to the required data.

Authorization

None

Required connection

None

API include file

sqlutil.h

API and data structure syntax

SQL_API_RC SQL_API_FN
  sqlgdref (
   unsigned int NumBytes,
   char * pTargetBuffer,
   char ** ppSourceBuffer);

sqlgdref API parameters

NumBytes: Input. An integer representing the number of bytes to be transferred.
pTargetBuffer: Output. Area into which the data are moved.
ppSourceBuffer: Input. A pointer to the area containing the required data.