傳回碼

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Platform System （PDW）

下載 OLE DB 驅動程式

在基本層級中，成員函數不是成功就是失敗。 不過，當函式成功時，其成功可能並非如應用程式開發人員所預期。

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

當 OLE DB Driver for SQL Server 成員函式傳回 S_OK 時，該函式已成功。

當 OLE DB Driver for SQL Server 成員函式沒有傳回 S_OK 時，OLE/COM HRESULT 解開的 FAILED 和 IS_ERROR 巨集可以決定函式的整體成功或失敗。

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

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

OLE DB Driver for SQL Server 成員函式不會傳回成功碼 S_FALSE。 所有 OLE DB Driver for SQL Server 成員函式一律傳回 S_OK 來表示成功。

另請參閱

錯誤