共用方式為


傳回碼

在大部分的基本層級,成員函數不是成功就是失敗。在更精確一點的層級,函數可能會成功,但是其成功可能不是應用程式開發人員所樂見的。

如需有關 OLE DB 傳回碼的詳細資訊,請參閱<傳回碼 (OLE DB)>(英文)。

當 SQL Server Native Client OLE DB 提供者成員函數傳回 S_OK 時,該函數會成功。

當 SQL Server Native Client OLE DB 提供者成員函數沒有傳回 S_OK 時,OLE/COM HRESULT 解開的 FAILED 和 IS_ERROR 巨集可以決定函數的整體成功或失敗。

如果 FAILED 或 IS_ERROR 傳回 TRUE,SQL Server Native Client OLE DB 提供者取用者可確保成員函數執行失敗。當 FAILED 或 IS_ERROR 傳回 FALSE,而且 HRESULT 不等於 S_OK 時,SQL Server Native Client OLE DB 提供者取用者可確保函數在某種意義上會成功。取用者可以擷取從 SQL Server Native Client OLE DB 提供者錯誤介面傳回的這個「條件式成功」(Success with Information) 的詳細資訊。同時,在函數清楚地失敗 (FAILED 巨集會傳回 TRUE) 的情況下,可從 SQL Server Native Client OLE DB 提供者錯誤介面取得擴充的錯誤資訊。

SQL Server Native Client OLE DB 提供者取用者通常會碰到 DB_S_ERRORSOCCURRED「條件式成功」(Success with Information) 的 HRESULT 傳回。傳回 DB_S_ERRORSOCCURRED 的成員函數通常會定義一或多個可提供狀態值給取用者的參數。取用者無法取得在狀態值參數中傳回之錯誤資訊以外的錯誤資訊,因此取用者應該在可取得錯誤資訊時,實作應用程式邏輯來擷取狀態值。

SQL Server Native Client OLE DB 提供者成員函數不會傳回成功碼 S_FALSE。所有 SQL Server Native Client OLE DB 提供者成員函數一律傳回 S_OK 來表示成功。

請參閱

概念