Partilhar via


Informações em interfaces de erro

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 Não há suporte. Sempre retorna zero.
GetHelpFile Não há 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ásicas sobre um erro. Uma estrutura ERRORINFO contém membros que identificam o valor retornado HRESULT para o erro e o provedor e a interface aos quais o erro se aplica.
GetCustomErrorObject Retorna uma referência nas 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 ao consumidor por meio de GetErrorParameters.
GetRecordCount Contagem de registros de erro disponíveis.

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. Os valores SQLSTATE são definidos nas especificações de SQL-92, ODBC e ISO SQL e 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 de erro do SQL Server de master.dbo.sysmessages quando disponível. 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.

Consulte Também

Erros