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 提供者一律會傳回零。 |