Partilhar via


Informações em interfaces de erro

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

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

O Driver OLE DB para SQL Server 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 suportado. Devolve sempre zero.
GetHelpFile Não suportado. Devolve sempre NULL.
GetSource String "Microsoft OLE DB Driver for SQL Server".

O Driver OLE DB para SQL Server suporta funções membros IErrorRecords disponíveis para consumidores, 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 Driver OLE DB para SQL Server não devolve parâmetros ao consumidor através do GetErrorParameters.
GetRecordCount Contagem de registos de erro disponíveis.

O Driver OLE DB para SQL Server suporta os parâmetros ISQLErrorInfo::GetSQLInfo conforme segue.

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 OLE DB Driver para SQL Server 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 um Driver OLE DB para a fonte de dados SQL Server. Antes da tentativa, o Driver OLE DB para SQL Server devolve sempre zero.

Ver também

Erros