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