Informação nas Interfaces de Erro definidas pelo OLE DB

Aplica-se a: SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)

O fornecedor do SQL Server Native Client OLE DB reporta alguma informação de erro e estado nas interfaces de erro definidas pelo OLE DB IErrorInfo, IErrorRecords e ISQLErrorInfo.

O fornecedor OLE DB do SQL Server Native Client suporta funções membros do IErrorInfo conforme segue.

Função de membro Description
GetDescription Cadeia de mensagem de erro descritiva.
GetGUID GUID da interface que definiu o erro.
GetHelpContext Não suportadas. Devolve sempre zero.
GetHelpFile Não suportadas. Sempre retorna NULL.
GetSource String "Microsoft SQL Server Native Client".

O fornecedor do SQL Server Native Client OLE DB suporta funções membros do IErrorRecords disponíveis para o consumidor, conforme segue.

Função de membro Description
GetBasicErrorInfo Preenche uma estrutura ERRORINFO com informações básicas sobre um erro. Uma estrutura ERRORINFO contém membros que identificam o valor de retorno HRESULT para o erro, bem como o fornecedor e interface a que o erro se aplica.
GetCustomErrorObject Devolve uma referência nas interfaces ISQLErrorInfo e ISQLServerErrorInfo.
GetErrorInfo Devolve uma referência numa interface do IErrorInfo .
GetErrorParameters O fornecedor OLE DB do SQL Server Native Client não devolve parâmetros ao consumidor através do GetErrorParameters.
GetRecordCount Contagem de registos de erro disponíveis.

O fornecedor SQL Server Native Client OLE DB suporta os parâmetros ISQLErrorInfo::GetSQLInfo da seguinte forma.

Parâmetro Description
pbstrSQLState Devolve um valor SQLSTATE para o erro. Os valores SQLSTATE são definidos nas especificações SQL-92, ODBC e ISO SQL, e API. Nem o SQL Server nem o fornecedor do SQL Server Native Client OLE DB definiram valores SQLSTATE específicos da implementação.
plNativeError Devolve o número de erro do SQL Server a partir 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 fornecedor OLE DB do SQL Server Native Client. Antes da tentativa, o fornecedor OLE DB do SQL Server Native Client devolve sempre zero.