Códigos de retorno (provedor OLE DB do cliente nativo)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

No nível mais básico, uma função de membro tem êxito ou falha. Em um nível um pouco mais preciso, uma função pode ser bem-sucedida, mas talvez seu êxito não seja o desejado pelo desenvolvedor do aplicativo.

Para obter mais informações sobre códigos de retorno do OLE DB, confira Códigos de retorno (OLE DB).

Quando uma função de membro do provedor OLE DB do SQL Server Native Client retorna S_OK, a função foi bem-sucedida.

Quando uma função de membro do provedor OLE DB do SQL Server Native Client não retorna S_OK, as macros OLE/COM HRESULT-UNPACKING FAILED e IS_ERROR podem determinar o sucesso ou a falha geral de uma função.

Se FAILED ou IS_ERROR retornar TRUE, o consumidor do provedor OLE DB do SQL Server Native Client terá a garantia de que a execução da função de membro falhou. Quando FAILED ou IS_ERROR retornar FALSE e o HRESULT não for igual a S_OK, o consumidor do provedor OLE DB do SQL Server Native Client terá a garantia de que a função foi bem-sucedida em algum sentido. O consumidor pode recuperar informações detalhadas sobre esse retorno de "sucesso com informações" das interfaces de erro do provedor OLE DB do SQL Server Native Client. Além disso, no caso em que uma função falha claramente (a macro FAILED retorna TRUE), as informações de erro estendidas estão disponíveis nas interfaces de erro do provedor OLE DB do SQL Server Native Client.

Os consumidores do provedor OLE DB do SQL Server Native Client geralmente encontram o DB_S_ERRORSOCCURRED retorno HRESULT de "sucesso com informações". Normalmente, funções de membro que retornam DB_S_ERRORSOCCURRED definem um ou mais parâmetros que fornecem valores de status ao consumidor. Talvez nenhuma informação de erro esteja disponível para o consumidor além daquela retornada em parâmetros de valor de status; assim, os consumidores devem implementar a lógica de aplicativo para recuperar valores de status quando eles estiverem disponíveis.

As funções de membro do provedor OLE DB do SQL Server Native Client não retornam o código de êxito S_FALSE. Todas as funções de membro do provedor OLE DB do SQL Server Native Client sempre retornam S_OK para indicar êxito.

Confira também

Erros