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 で定義されたエラー インターフェイス IErrorInfo、 IErrorRecords、および 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 を返します。 |