ホスト変数を C タイプにバインドするための関数

すべてのコード化スキームにおいて、一般 API の SQLBindCol()、 SQLBindParameter()、 および SQLGetData() をエントリー・ポイントとして使用し、アプリケーション変数をバインドします。Db2® ODBC では、アプリケーション変数をバインドする関数に対して、単一のエントリー・ポイント のみが必要です。

Db2 ODBC ドライバーは、以下の指定によって、これらの関数での文字データのコード化スキームを 判別します。
  • SQLBindCol()、SQLBindParameter()、および SQLGetData() における fCType 引数値。
  • fCType 引数値が SQL_C_WCHAR でない場合は、Db2 ODBC 初期設定ファイルの CURRENTAPPENSCH キーワードの設定値。

    fCType が SQL_C_WCHAR の場合は、コード化スキームは、CURRENTAPPENSCH 設定値に関係なく、ユニコード UCS-2 になります。

次の表は、各コード化スキーム内でアプリケーション をバインドするための、CURRENTAPPENSCH キーワードの設定、アプリケーション変数の宣言、 および引数 fCType の宣言の方法について要約したものです。

表 1. 各コード化スキーム内でアプリケーション変数をバインドするために必要な値
Db2 ODBC エレメント EBCDIC ユニコード UCS-2 ユニコード UTF-8 ASCII
CURRENTAPPENSCH キーワード設定値 EBCDIC (デフォルト) 適用されない。 UNICODE ASCII
アプリケーション変数 C タイプ定義 SQLCHAR または SQLDBCHAR SQLWCHAR SQLCHAR SQLCHAR または SQLDBCHAR
SQLBindParameter()、SQLBindCol()、または SQLGetData() の fCType SQL_C_CHAR または SQL_C_DBCHAR SQL_C_WCHAR SQL_C_CHAR SQL_C_CHAR または SQL_C_DBCHAR

要件: 引数 fCType には、アプリケーション変数で使用するデータ・タイプに対応する シンボリック C データ・タイプを使用する必要があります。 例えば、SQLCHAR アプリケーション変数をバインドする場合は、バインド関数呼び出しの引数 fCType には、シンボリック C データ・タイプ SQL_C_CHAR を指定する必要があります。