OLE DB 定義錯誤介面中的資訊
適用於: SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 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 提供者一律會傳回零。 |