Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna um ponteiro para uma estrutura SSERRORINFO do provedor OLE DB do SQL Server Native Client que contém os detalhes do erro do SQL Server.
Sintaxe
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Argumentos
ppSSErrorInfo[out]
Um ponteiro para uma estrutura SSERRORINFO. Se o método falhar ou não houver informações do SQL Server associadas ao erro, o provedor não alocará nenhuma memória e garantirá que o argumento ppSSErrorInfo seja um ponteiro nulo na saída.
ppErrorStrings[out]
Um ponteiro para um ponteiro de cadeia de caracteres Unicode. Se o método falhar ou não houver informações do SQL Server associadas a um erro, o provedor não alocará nenhuma memória e garantirá que o argumento ppErrorStrings seja um ponteiro nulo na saída. Liberar o argumento ppErrorStrings com o método IMalloc::Free libera os três membros de cadeia de caracteres individuais da estrutura SSERRORINFO retornada, pois a memória é alocada em um bloco.
Valores do código de retorno
S_OK
O método foi bem-sucedido.
E_INVALIDARG
O ppSSErrorInfo ou o argumento ppErrorStrings era NULL.
E_OUTOFMEMORY
O provedor OLE DB do SQL Server Native Client não pôde alocar memória suficiente para concluir a solicitação.
Observações
O provedor OLE DB do SQL Server Native Client aloca memória para as cadeias de caracteres SSERRORINFO e OLECHAR retornadas por meio dos ponteiros passados pelo consumidor. O consumidor deve desalocar essa memória usando o método IMalloc::Free quando não precisar mais de acesso aos dados de erro.
A estrutura SSERRORINFO é definida da seguinte maneira:
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
| Membro | Descrição |
|---|---|
| pwszMessage | A mensagem de erro do SQL Server. A mensagem é retornada por meio do método IErrorInfo::GetDescription . |
| pwszServer | O nome da instância do SQL Server na qual o erro ocorreu. |
| pwszProcedure | O nome do procedimento armazenado que gera o erro se o erro ocorreu em um procedimento armazenado; caso contrário, uma cadeia de caracteres vazia. |
| LNative | O número de erro do SQL Server. O número de erro é idêntico ao retornado no parâmetro plNativeError do método ISQLErrorInfo::GetSQLInfo . |
| bState | O estado do erro do SQL Server. |
| bClass | A gravidade do erro do SQL Server. |
| wLineNumber | Quando aplicável, a linha de um procedimento armazenado do SQL Server que gerou a mensagem de erro. Se nenhum procedimento estiver envolvido, o valor padrão será 1. |
Ponteiros nos endereços de referência da estrutura na cadeia de caracteres retornada no argumento ppErrorStrings .