診断の処理規則

  • [アーティクル]

次の規則は、SQLGetDiagRec と SQLGetDiagField の診断処理を制御します。

すべての ODBC コンポーネント:

  • 別の ODBC コンポーネントから受信したエラーや警告を置換、変更、マスクすることはできません。

  • 別の ODBC コンポーネントから診断メッセージを受信したときに、追加の状態レコードを追加できます。 追加されたレコードは、元のメッセージに実際の情報値を追加する必要があります。

データ ソースに直接インターフェイスする ODBC コンポーネントの場合:

  • ベンダー識別子、コンポーネント識別子、およびデータ ソースの識別子に、データ ソースから受信する診断メッセージの前にプレフィックスを付ける必要があります。

  • データ ソースのネイティブ エラー コードを保持する必要があります。

  • データ ソースの診断メッセージを保持する必要があります。

データ ソースに依存しないエラーまたは警告を生成する ODBC コンポーネントの場合:

  • エラーまたは警告に対して正しい SQLSTATE を指定する必要があります。

  • 診断メッセージのテキストを生成する必要があります。

  • 診断メッセージにベンダー識別子とそのコンポーネント識別子のプレフィックスを付ける必要があります。

  • ネイティブ エラー コードが使用可能で意味がある場合は、返す必要があります。

ドライバー マネージャーとインターフェイスする ODBC コンポーネントの場合:

  • SQLGetDiagRec と SQLGetDiagField の出力引数を初期化する必要があります。

  • その関数が呼び出されたときに、診断情報を SQLGetDiagRec および SQLGetDiagField の出力引数として書式設定して返す必要があります。

ドライバー マネージャー以外の 1 つの ODBC コンポーネントの場合:

  • ネイティブ エラーに基づいて SQLSTATE を設定する必要があります。 ゲートウェイを使用しないファイル ベースのドライバーと DBMS ベースのドライバーの場合、ドライバーは SQLSTATE を設定する必要があります。 ゲートウェイを使用する DBMS ベースのドライバーの場合、ODBC をサポートするドライバーまたはゲートウェイで SQLSTATE を設定できます。