Compartilhar via

Classe CDBErrorInfo

  • Artigo

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 Devolução

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:

  1. o valor de lcid NÃO é inglês americano e

  2. 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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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