Share via


OLE DB 定義錯誤介面中的資訊

適用於:SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics 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 ISQLErrorInfoISQLServerErrorInfo 介面上傳回參考。
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 提供者一律會傳回零。

另請參閱

錯誤