SQLGetDescField および SQLGetDescRec (カーソル ライブラリ)

重要

この機能は、Windows の将来のバージョンで削除される予定です。 新しい開発作業ではこの機能を使用しないでください。また、現在この機能を使用しているアプリケーションの変更を計画してください。 Microsoft では、ドライバーのカーソル機能を使用することをお勧めします。

このトピックでは、カーソル ライブラリでの SQLGetDescField 関数と SQLGetDescRec 関数の使用について説明します。 これらの関数の一般的な情報については、「 SQLGetDescField 関数 」および 「SQLGetDescRec 関数」を参照してください。

カーソル ライブラリは SQLGetDescRec を実行して、ブックマーク列のメタデータを返します。 カーソル ライブラリは SQLGetDescField を実行して、 SQLGetDescRec によって返されるのと同じフィールド (SQL_DESC_NAME、SQL_DESC_TYPE、SQL_DESC_DATETIME_INTERVAL_CODE、SQL_DESC_OCTET_LENGTH、SQL_DESC_PRECISION、SQL_DESC_SCALE、SQL_DESC_NULLABLE) を返します。 一貫性を確保するために、 SQLGetDescField はSQL_DESC_UNNAMEDも返します。

カーソル ライブラリは、呼び出されたときに SQLGetDescField を実行して、SQL_DESC_DATA_PTR、SQL_DESC_INDICATOR_PTR、SQL_DESC_OCTET_LENGTH_PTR、SQL_DESC_LENGTHのバインドに設定されているフィールドの値を返します。

カーソル ライブラリは、 SQLGetDescField が呼び出されたときに SQLGetDescField を実行して、SQL_DESC_BIND_OFFSET_PTR、SQL_DESC_BIND_TYPE、SQL_DESC_ROW_ARRAY_SIZE、または SQL_DESC_ROW_STATUS_PTR フィールドの値を返します。 これらのフィールドは、ブックマーク行だけでなく、任意の行に対して返すことができます。

アプリケーションが SQLGetDescField を呼び出して、前述以外のフィールドの値を返す場合、カーソル ライブラリはドライバーに呼び出しを渡します。