錯誤介面中的資訊
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 提供者一律會傳回零。 |