Códigos de retorno
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 OLE DB, consulte 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 teve êxito.
Quando uma função de membro do provedor OLE DB do SQL Server Native Client não retorna S_OK, as macros FAILED e IS_ERROR de descompactação de HRESULT de OLE/COM podem determinar o êxito 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á certeza 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á certeza de que, de alguma forma, a função teve êxito. O consumidor pode recuperar informações detalhadas sobre este retorno de “êxito com informações” nas interfaces de erro do provedor OLE DB do SQL Server Native Client. Além disso, quando uma função falhar claramente (a macro FAILED retornar TRUE), as informações de erro estendidas estarão disponíveis nas interfaces de erro do provedor OLE DB do SQL Server Native Client.
É comum os consumidores do provedor OLE DB do SQL Server Native Client encontrarem o retorno de HRESULT “êxito com informações” do DB_S_ERRORSOCCURRED. 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.