C から SQL へのデータ変換

C データ・タイプから SQL データ・タイプに変換するには、引数 fSqlType と pcbValue を理解しておく必要があります。各変換の結果に対して SQLSTATE が戻されます。

それぞれの C データ変換タイプごとに、表に変換情報が示されています。 これらの表でそれぞれの欄では、以下の情報をリストしています。
  • 表の最初の欄は、SQLBindParameter() の引数 fSqlType の 有効な入力値を示しています。
  • 2 番目の欄では、ドライバーが、データを変換できるかどうかを判別するために行うテスト の結果を示しています。このテストでは、SQLBindParameter() の引数 pcbValue で指定されたパラメーター・データの長さ (単位: バイト) がよく使用されます。
  • 3 番目の欄では、SQLExecDirect() または SQLExecute() によって、それぞれの結果ごと戻される SQLSTATE を示しています。
    重要: SQLSTATE が 00000 (成功) の場合にのみ、 データがデータ・ソースに送られます。

この表では、ある特定の SQL データ・タイプについて、ODBC が有効であると定義している変換を 示しています。

ある特定の C データ・タイプについて、表に示されていない値が SQLBindParameter() の引数 fSqlType に含まれている場合 は、SQLSTATE 07006 が戻されます (データ・タイプ属性制約違反)。

表には示されていてもドライバーがサポートしていない変換を指定した値が 引数 fSqlType に含まれている場合、SQLBindParameter() は 、SQLSTATE HYC00 (ドライバーが使用不可能) を戻します。

SQLBindParameter() で指定された引数 rgbValue およ び pcbValue が両方とも NULL ポインターの場合、 その関数は SQLSTATE HY009 (引数値が無効) を戻します。

データ長
指定された SQL データ・タイプに変換後のデータのバイト単位での全長 (データがストリングに 変換された場合の NUL 終了文字を除く)。 これは、データ・ソースに送られる前にデータが切り捨てられる場合にも当てはまります。
列の長さ
データがデフォルトの C データ・タイプに移されるときに アプリケーションに戻されるバイトの最大数。 文字データの場合、長さには NUL 終了文字は含まれません。
表示サイズ
文字形式でデータを表示するのに必要なバイトの最大数。
有効数字
負符号 (必要な場合) と小数点の左側の数字。