Hitachi

Hitachi Advanced Database Application Development Guide


19.7.2 a_rdb_SQLNameInfo_t structure (name information)

Organization of this subsection

(1) Function

Name information, such as the column names of the retrieval result columns acquired by a_rdb_SQLDescribeCols(), is stored in a_rdb_SQLNameInfo_t structures. For details about a_rdb_SQLDescribeCols(), see 19.4.6 a_rdb_SQLDescribeCols() (acquire information about the retrieval result columns).

(2) Format

typedef struct a_rdb_TG_NameInfo {
  unsigned short   NameLength ;                 /* Out */
  unsigned short   BufferLength ;               /* In * /
  char             _NameInfo_rsv01[4] ;
  char            *Name ;                       /* Out */
} a_rdb_SQLNameInfo_t ;

(3) Members

NameLength

Acquires the length of a name (in bytes).

BufferLength

Specifies the size (in bytes) of the area in which the name is to be acquired.

Name

Specifies the address of the area in which the name is to be stored.

(4) Notes

When you use a a_rdb_SQLNameInfo_t structure, make sure that you first initialize the area to zeros and then specify a value for each member to be used.