Classe CDBErrorInfo
Fornece suporte para processamento de erros do OLE DB usando a interface IErrorRecords do OLE DB.
Sintaxe
class CDBErrorInfo
Requisitos
Cabeçalho: atldbcli.h
Membros
Métodos
| Nome | Descrição |
|---|---|
| GetAllErrorInfo | Retorna todas as informações de erro contidas em um registro de erro. |
| GetBasicErrorInfo | Chama IErrorRecords::GetBasicErrorInfo para retornar informações básicas sobre o erro especificado. |
| GetCustomErrorObject | Chama IErrorRecords::GetCustomErrorObject para retornar um ponteiro para uma interface em um objeto de erro personalizado. |
| GetErrorInfo | Chama IErrorRecords::GetErrorInfo para retornar um ponteiro de interface IErrorInfo ao registro especificado. |
| GetErrorParameters | Chama IErrorRecords::GetErrorParameters para retornar os parâmetros de erro. |
| GetErrorRecords | Obtém registros de erro para o objeto especificado. |
Comentários
Essa interface retorna um ou mais registros de erro ao usuário. Chame CDBErrorInfo::GetErrorRecords primeiro para obter uma contagem de registros de erro. Em seguida, chame uma das funções de acesso, como CDBErrorInfo::GetAllErrorInfo, para recuperar informações de erro para cada registro.
CDBErrorInfo::GetAllErrorInfo
Retorna todas as informações de tipo de erro contidas em um registro de erro.
Sintaxe
HRESULT GetAllErrorInfo(ULONG ulRecordNum,
LCID lcid, BSTR* pbstrDescription,
BSTR* pbstrSource = NULL,
GUID* pguid = NULL,
DWORD* pdwHelpContext = NULL,
BSTR* pbstrHelpFile = NULL) const throw();
Parâmetros
ulRecordNum
[entrada] O número baseado em zero do registro para o qual retornar informações de erro.
lcid
[entrada] A ID da localidade para as informações de erro a serem retornadas.
pbstrDescription
[saída] Um ponteiro para uma descrição de texto do erro ou NULL se não houver suporte para a localidade. Consulte Observações.
pbstrSource
[out] Um ponteiro para uma cadeia de caracteres que contém o nome do componente que gerou o erro.
pguid
[out] Um ponteiro para o GUID da interface que definiu o erro.
pdwHelpContext
[out] Um ponteiro para a ID de contexto de ajuda para o erro.
pbstrHelpFile
[out] Um ponteiro para uma cadeia de caracteres que contém o caminho para o arquivo de ajuda que descreve o erro.
Valor de retorno
S_OK se for bem-sucedido. Confira IErrorRecords::GetErrorInfo na Referência do Programador do OLE DB para outros valores retornados.
Comentários
O valor de saída de pbstrDescription é obtido internamente pela chamada de IErrorInfo::GetDescription, que define o valor como NULL se a localidade não tiver suporte ou se ambas as seguintes condições forem verdadeiras:
o valor de lcid NÃO é inglês americano e
o valor de lcid NÃO é igual ao valor retornado por GetUserDefaultLCID.
CDBErrorInfo::GetBasicErrorInfo
Chama IErrorRecords::GetBasicErrorInfo para retornar informações básicas sobre o erro, como o código de retorno e o número de erro específico do provedor.
Sintaxe
HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
ERRORINFO* pErrorInfo) const throw();
Parâmetros
Confira IErrorRecords::GetBasicErrorInfo na Referência do Programador do OLE DB.
Valor de retorno
Um valor HRESULT padrão.
CDBErrorInfo::GetCustomErrorObject
Chama IErrorRecords::GetCustomErrorObject para retornar um ponteiro para uma interface em um objeto de erro personalizado.
Sintaxe
HRESULT GetCustomErrorObject(ULONG ulRecordNum,
REFIID riid,IUnknown** ppObject) const throw();
Parâmetros
Confira IErrorRecords::GetCustomErrorObject na Referência do Programador do OLE DB.
Valor de retorno
Um valor HRESULT padrão.
CDBErrorInfo::GetErrorInfo
Chama IErrorRecords::GetErrorInfo para retornar um ponteiro de interface IErrorInfo ao registro especificado.
Sintaxe
HRESULT GetErrorInfo(ULONG ulRecordNum,
LCID lcid,IErrorInfo** ppErrorInfo) const throw();
Parâmetros
Confira IErrorRecords::GetErrorInfo na Referência do Programador do OLE DB.
Valor de retorno
Um valor HRESULT padrão.
CDBErrorInfo::GetErrorParameters
Chama IErrorRecords::GetErrorParameters para retornar os parâmetros de erro.
Sintaxe
HRESULT GetErrorParameters(ULONG ulRecordNum,
DISPPARAMS* pdispparams) const throw();
Parâmetros
Confira IErrorRecords::GetErrorParameters na Referência do Programador do OLE DB.
Valor de retorno
Um valor HRESULT padrão.
CDBErrorInfo::GetErrorRecords
Obtém registros de erro para o objeto especificado.
Sintaxe
HRESULT GetErrorRecords(IUnknown* pUnk,
const IID& iid,
ULONG* pcRecords) throw();
HRESULT GetErrorRecords(ULONG* pcRecords) throw();
Parâmetros
pUnk
[in] Interface para o objeto para o qual obter registros de erro.
iid
[in] A IID da interface associada ao erro.
pcRecords
[out] Um ponteiro para a contagem (baseada em um) de registros de erro.
Valor de retorno
Um valor HRESULT padrão.
Comentários
Use a primeira forma da função se quiser verificar de qual interface obter as informações de erro. Caso contrário, use a segunda forma.
Confira também
DBViewer
Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB