ホスト変数を 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 の宣言の方法について要約したものです。
| 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 を指定する必要があります。