Hitachi

Hitachi Advanced Database Application Development Guide


16.2 Notes about SQLxxx and SQLxxxW functions

This section provides notes about the following functions that are described in this chapter:

■ Notes about both the Windows version and the Linux version of HADB client

Arguments that use an SQLxxx function to define the SQLCHAR type in ODBC 3.0 use an SQLxxxW function to define the SQLWCHAR type in ODBC 3.5.

The units for parameters that specify lengths are as follows:

  • SQLxxx functions in ODBC 3.0: Lengths are in bytes

  • SQLxxxW functions in ODBC 3.5

    • For a parameter of the SQLPOINTER type: Lengths are in bytes

    • For a parameter of the SQLWCHAR type: Lengths are in characters

■ Notes about the Linux version of HADB client

For SQLxxxW functions in ODBC 3.5, byte length is sometimes specified instead of character count for arguments that specify length. In these cases, if an odd number of bytes is specified, it is internally converted to a valid character count (↓specified-byte-length ÷ 2↓ × 2) for processing.

For those functions whose names differ between ODBC 3.0 and ODBC 3.5, the SQLxxx function used in ODBC 3.0 is explained first, and then the SQLxxxW function used in ODBC 3.5 is explained.