Códigos de retorno

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

Baixar o driver do OLE DB

No nível básico, uma função de membro é bem-sucedida ou falha. No entanto, quando uma função é bem-sucedida, o êxito dela pode não ser o que o desenvolvedor do aplicativo pretendia.

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 Driver do OLE DB para SQL Server retorna S_OK, a função teve êxito.

Quando uma função de membro do OLE DB Driver for SQL Server 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 OLE DB Driver for SQL Server 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 Driver do OLE DB para SQL Server 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 OLE DB Driver for SQL Server. Além disso, se uma função falhar claramente (a macro FAILED retorna TRUE), as informações de erro estendidas ficarão disponíveis nas interfaces de erro do OLE DB Driver for SQL Server.

É comum os consumidores do Driver do OLE DB para SQL Server 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 deverão implementar a lógica de aplicativo para recuperar valores de status quando eles estiverem disponíveis.

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

Consulte Também

Erros