Compartilhar via


Informações em interfaces de erro

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

O OLE DB Driver for SQL Server relata algumas informações sobre erros e status nas interfaces de erro definidas por OLE DB IErrorInfo, IErrorRecords e ISQLErrorInfo.

O Driver do OLE DB para SQL Server dá suporte a funções de membro IErrorInfo como a seguir.

Função de membro Descrição
GetDescription Cadeia de caracteres de mensagem de erro descritiva.
GetGUID GUID da interface que definiu o erro.
GetHelpContext Sem suporte. Sempre retorna zero.
GetHelpFile Sem suporte. Sempre retorna NULL.
GetSource Cadeia de caracteres "Microsoft OLE DB Driver for SQL Server".

O Driver do OLE DB para SQL Server dá suporte a funções de membro IErrorInfo disponíveis para consumidor como a seguir.

Função de membro Descrição
GetBasicErrorInfo Preenche uma estrutura ERRORINFO com informações básica sobre um erro. Uma estrutura ERRORINFO contém membros que identificam o valor de retorno HRESULT para o erro e o provedor e interface aos quais o erro se aplica.
GetCustomErrorObject Retorna uma referência em interfaces ISQLErrorInfo e ISQLServerErrorInfo.
GetErrorInfo Retorna uma referência em uma interface IErrorInfo.
GetErrorParameters O Driver do OLE DB para SQL Server não retorna parâmetros para o consumidor por meio de GetErrorParameters.
GetRecordCount Contagem de registros de erro disponível.

O Driver do OLE DB para SQL Server dá suporte para os parâmetros ISQLErrorInfo::GetSQLInfo como a seguir.

Parâmetro Descrição
pbstrSQLState Retorna um valor SQLSTATE para o erro. São definidos valores SQLSTATE nas especificações SQL-92, ODBC ISO SQL e de API. Nem o SQL Server nem o Driver do OLE DB para SQL Server definiram valores SQLSTATE específicos de implementação.
plNativeError Retorna o número do erro do SQL Server de master.dbo.sysmessages quando disponível. Os erros nativos estão disponíveis após uma tentativa bem-sucedida de inicializar uma fonte de dados do Driver do OLE DB para SQL Server. Antes da tentativa, o Driver do OLE DB para SQL Server sempre retorna zero.

Consulte Também

Erros