Informações em interfaces de erro
O provedor OLE DB do SQL Server Native Client relata alguns erros e informações de 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 SQL Server Native Client não retorna parâmetros ao 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 SQL Server nem o provedor OLE DB SQL Server Native Client definiu valores SQLSTATE específicos da implementação. |
| plNativeError | Retorna o número do 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 um SQL Server Native Client fonte de dados do provedor OLE DB. Antes da tentativa, o provedor OLE DB SQL Server Native Client sempre retorna zero. |