Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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
Retorna um ponteiro para um Driver OLE DB para a estrutura SSERRORINFO do SQL Server contendo os detalhes de erro do SQL Server.
O Driver OLE DB para SQL Server define a interface de erro ISQLServerErrorInfo . Esta interface devolve detalhes de um erro do SQL Server, incluindo a sua gravidade e estado.
Sintaxe
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Arguments
ppSSErrorInfo[encerrado]
Um apontador para uma estrutura SSERRORINFO. Se o método falhar ou não houver informação SQL Server associada ao erro, o fornecedor não aloca memória e garante que o argumento ppSSErrorInfo é um ponteiro nulo na saída.
ppErrorStrings[desligado]
Um ponteiro para um ponteiro de stringas de caracteres Unicode. Se o método falhar ou não houver informação SQL Server associada a um erro, o fornecedor não aloca memória e garante que o argumento ppErrorStrings é um ponteiro nulo na saída. Libertar o argumento ppErrorStrings com o método IMalloc::Free liberta os três membros individuais da string da estrutura SSERRORINFO retornada, pois a memória é alocada num bloco.
Valores do código de retorno
S_OK
O método teve sucesso.
E_INVALIDARG
Ou o argumento ppSSErrorInfo ou ppErrorStrings era NULL.
E_OUTOFMEMORY
O Driver OLE DB para SQL Server não conseguia alocar memória suficiente para completar o pedido.
Observações
O Driver OLE DB para SQL Server aloca memória para as strings SSERRORINFO e OLECHAR devolvidas através dos ponteiros passados pelo consumidor. O consumidor deve desalocar esta memória usando o método IMalloc::Free quando já não requer acesso aos dados de erro.
A estrutura SSERRORINFO é definida da seguinte forma:
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
| Membro | Description |
|---|---|
| pwszMessage | A mensagem de erro do SQL Server. A mensagem é devolvida através do método IErrorInfo::GetDescription . |
| pwszServer | O nome da instância do SQL Server onde ocorreu o erro. |
| pwszProcedimento | O nome do procedimento armazenado que gera o erro caso o erro ocorresse num procedimento armazenado; caso contrário, uma cadeia vazia. |
| Nativo | O número de erro do SQL Server. O número de erro é idêntico ao devolvido no parâmetro plNativeError do método ISQLErrorInfo::GetSQLInfo. |
| bEstado | O estado do erro do SQL Server. |
| Classe b | A gravidade do erro do SQL Server. |
| wNúmero de Linha | Quando aplicável, a linha de um SQL Server armazenou o procedimento que gerou a mensagem de erro. Se não houver procedimento envolvido, o valor padrão é 1. |
Os ponteiros na estrutura referem-se à cadeia retornada no argumento ppErrorStrings .