傳回碼 （Native Client OLE DB 提供者）

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

在最基本的層級上，成員函式會成功或失敗。 在更精確的層級上，函式可以成功，但其成功可能不是應用程式開發人員所想要的。

如需 OLE DB 傳回碼的詳細資訊，請參閱 Return Codes (OLE DB) (傳回碼 (OLE DB))。

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

當 SQL Server Native Client OLE DB 提供者成員函式未傳回S_OK時，OLE/COM HRESULT-unpacking 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 提供者錯誤介面擷取這個「成功與資訊」傳回的詳細資訊。 此外，如果函式明顯失敗（FAILED 宏傳回 TRUE），SQL Server Native Client OLE DB 提供者錯誤介面會提供擴充錯誤資訊。

SQL Server Native Client OLE DB 提供者取用者通常會遇到DB_S_ERRORSOCCURRED「成功與資訊」HRESULT 傳回。 傳回 DB_S_ERRORSOCCURRED 的成員函數通常會定義一或多個可提供狀態值給取用者的參數。 除了在狀態值參數中傳回的錯誤資訊之外，取用者無法取得任何錯誤資訊，因此取用者應該實作應用程式邏輯，以便在可用時擷取狀態值。

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

另請參閱

錯誤