Compartilhar via


Informações em interfaces de erro definidas pelo OLE DB

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

O provedor OLE DB do SQL Server Native Client relata algumas informações de erro e status nas interfaces de erro definidas pelo OLE DB IErrorInfo, IErrorRecords e ISQLErrorInfo.

O provedor OLE DB do SQL Server Native Client dá suporte a funções de membro IErrorInfo da seguinte maneira.

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 SQL Server Native Client".

O provedor OLE DB do SQL Server Native Client dá suporte a funções de membro IErrorRecords disponíveis para o consumidor da seguinte maneira.

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 provedor OLE DB do SQL Server Native Client não retorna parâmetros para o consumidor por meio de GetErrorParameters.
GetRecordCount Contagem de registros de erro disponível.

O provedor OLE DB do SQL Server Native Client dá suporte aos parâmetros ISQLErrorInfo::GetSQLInfo da seguinte maneira.

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 provedor OLE DB do SQL Server Native Client definiram valores SQLSTATE específicos da 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 provedor OLE DB do SQL Server Native Client. Antes da tentativa, o provedor OLE DB do SQL Server Native Client sempre retorna zero.

Confira também

Erros