Partilhar via


Informações em interfaces de erro

O provedor OLE DB do SQL Server Native Client reporta algumas informações sobre erros e status nas interfaces de erro definidas por OLE DB IErrorInfo, IErrorRecordse ISQLErrorInfo.

O provedor OLE DB do SQL Server Native Client 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 SQL Server Native Client".

O provedor OLE DB do SQL Server Native Client dá suporte a funções de membro IErrorRecords disponíveis ao 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 eISQLServerErrorInfo.

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 a 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 provedor OLE DB do SQL Server Native Client definiram valores SQLSTATE específicos de implementação.

plNativeError

Retorna o número de 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 retorna sempre zero.

Consulte também

Conceitos