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. |