返回代码

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

下载 OLE DB 驱动程序

在基本级别，成员函数要么成功，要么失败。 但是，函数成功可能并不是应用程序开发人员所期望的结果。

有关 OLE DB 返回代码的详细信息，请参阅 Return Codes (OLE DB)（返回代码 (OLE DB)）。

如果 OLE DB Driver for SQL Server 的某成员函数返回 S_OK，则表明该函数执行成功。

如果适用于 SQL Server 的 OLE DB 驱动程序的成员函数未返回 S_OK，则 OLE/COM HRESULT-unpacking FAILED 和 IS_ERROR 宏判断此函数总体上是否成功。

如果 FAILED 或 IS_ERROR 返回 TRUE，则适用于 SQL Server 的 OLE DB 驱动程序的使用者可确定成员函数执行失败。 如果 FAILED 或 IS_ERROR 返回 FALSE，并且 HRESULT 不等于 S_OK，则 OLE DB Driver for SQL Server 的使用者可以肯定函数在某种意义上执行成功。 使用者可在适用于 SQL Server 的 OLE DB 驱动程序错误接口返回的“成功但存在错误”消息中检索详细信息。 此外，如果函数明显执行失败（FAILED 宏返回 TRUE），也可从适用于 SQL Server 的 OLE DB 驱动程序错误接口获取详细的错误信息。

OLE DB Driver for SQL Server 的使用者经常会遇到 HRESULT 返回 DB_S_ERRORSOCCURRED“成功但存在错误”。 通常，返回 DB_S_ERRORSOCCURRED 的成员函数会定义一个或多个将状态值传递给使用者的参数。 除了在状态值参数中返回的错误信息，使用者无法获得其他任何错误信息，因此使用者需将应用程序实现为存在状态值可检索这些值。

OLE DB Driver for SQL Server 成员函数不返回成功代码 S_FALSE。 OLE DB Driver for SQL Server 的所有成员函数总是返回 S_OK 来指示执行成功。

另请参阅

错误