次の方法で共有


OLE DB 定義エラー インターフェイスの情報

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQL Server Native Client OLE DB プロバイダーは、OLE DB で定義されたエラー インターフェイス IErrorInfoIErrorRecords、および ISQLErrorInfo のエラーと状態の情報を報告します。

SQL Server Native Client OLE DB プロバイダーは、次のように IErrorInfo メンバー関数をサポートします。

メンバー関数 説明
GetDescription エラー メッセージを説明する文字列を返します。
GetGUID エラーを定義したインターフェイスの GUID を返します。
GetHelpContext サポートされていません。 常にゼロが返されます。
GetHelpFile サポートされていません。 常に NULL が返されます。
GetSource 文字列 "Microsoft SQL Server Native Client" を返します。

SQL Server Native Client OLE DB プロバイダーは、次のようにコンシューマーが使用できる IErrorRecords メンバー関数をサポートします。

メンバー関数 説明
GetBasicErrorInfo エラーに関する基本情報を ERRORINFO 構造体に設定します。 ERRORINFO 構造体には、エラーの HRESULT 戻り値およびエラーが適用されるプロバイダーとインターフェイスを特定するメンバーが含まれます。
GetCustomErrorObject ISQLErrorInfo インターフェイスと ISQLServerErrorInfo インターフェイスの参照を返します。
GetErrorInfo IErrorInfo インターフェイスの参照を返します。
GetErrorParameters SQL Server Native Client OLE DB プロバイダーは、 GetErrorParameters を介してコンシューマーにパラメーターを返しません。
GetRecordCount 使用できるエラー レコードの数を返します。

SQL Server Native Client OLE DB プロバイダーは、次のように ISQLErrorInfo::GetSQLInfo パラメーターをサポートします。

パラメーター 説明
pbstrSQLState エラーの SQLSTATE 値を返します。 SQLSTATE 値は、SQL-92、ODBC と ISO SQL、および API の各仕様で定義されています。 SQL Server と SQL Server Native Client OLE DB プロバイダーのどちらも、実装固有の SQLSTATE 値を定義しません。
plNativeError 該当する場合は、master.dbo.sysmessages から SQL Server のエラー番号を返します。 ネイティブ エラーは、SQL Server Native Client OLE DB プロバイダー データ ソースの初期化が成功した後に使用できます。 試行する前に、SQL Server Native Client OLE DB プロバイダーは常に 0 を返します。

参照

エラー