通过

返回代码（Native Client OLE DB 访问接口）

  • 项目

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统（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 解压缩 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以指示成功。

另请参阅

错误