Partilhar via

Classe IErrorRecordsImpl

  • Artigo

Implementa a interface OLE DB IErrorRecords, adicionando registros e recuperando registros de um membro de dados (m_rgErrors) do tipo CAtlArray<RecordClass>.

Sintaxe

template <class T, class RecordClass = ATLERRORINFO>
class IErrorRecordsImpl : public IErrorRecords

Parâmetros

T
Uma classe derivada de IErrorRecordsImpl.

RecordClass
Uma classe que representa um objeto de erro OLE DB.

Requisitos

Cabeçalho: atldb.h

Membros

Métodos

Nome Descrição
GetErrorDescriptionString Obtém a cadeia de caracteres de descrição do erro de um registro de erro.
GetErrorGUID Obtém o GUID de erro de um registro de erro.
GetErrorHelpContext Obtém a ID do contexto de ajuda de um registro de erro.
GetErrorHelpFile Obtém o nome do caminho completo do arquivo de ajuda de um registro de erro.
GetErrorSource Obtém o código-fonte de erro de um registro de erro.

Métodos de interface

Nome Descrição
AddErrorRecord Adiciona um registro ao objeto de erro OLE DB.
GetBasicErrorInfo Retorna informações básicas sobre o erro, como o código de retorno e o número do erro específico do provedor.
GetCustomErrorObject Retorna um ponteiro para uma interface em um objeto de erro personalizado.
GetErrorInfo Retorna um ponteiro de interface IErrorInfo no registro especificado.
GetErrorParameters Retorna os parâmetros de erro.
GetRecordCount Retorna o número de registros no objeto de registro OLE DB.

Membros de dados

Nome Descrição
m_rgErrors Uma matriz de registros de erro.

IErrorRecordsImpl::GetErrorDescriptionString

Obtém a cadeia de caracteres de descrição do erro de um registro de erro.

Sintaxe

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

Parâmetros

rCurError
Um registro ERRORINFO em uma interface IErrorInfo.

Valor de retorno

Um ponteiro para uma cadeia de caracteres que descreve o erro.

IErrorRecordsImpl::GetErrorGUID

Obtém o GUID de erro de um registro de erro.

Sintaxe

REFGUID GetErrorGUID(ERRORINFO& rCurError);

Parâmetros

rCurError
Um registro ERRORINFO em uma interface IErrorInfo.

Valor de retorno

Uma referência a um GUID para o erro.

IErrorRecordsImpl::GetErrorHelpContext

Obtém a ID do contexto de ajuda de um registro de erro.

Sintaxe

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Parâmetros

rCurError
Um registro ERRORINFO em uma interface IErrorInfo.

Valor de retorno

A ID do contexto de ajuda para o erro.

IErrorRecordsImpl::GetErrorHelpFile

Obtém o nome do caminho do arquivo de ajuda de um registro de erro.

Sintaxe

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

Parâmetros

rCurError
Um registro ERRORINFO em uma interface IErrorInfo.

Valor de retorno

Ponteiro para uma cadeia de caracteres que contém o nome do caminho do arquivo de ajuda para o erro.

IErrorRecordsImpl::GetErrorSource

Obtém o código-fonte que causou o erro de um registro de erro.

Sintaxe

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

Parâmetros

rCurError
Um registro ERRORINFO em uma interface IErrorInfo.

Valor de retorno

Ponteiro para uma cadeia de caracteres que contém o código-fonte do erro.

IErrorRecordsImpl::AddErrorRecord

Adiciona um registro ao objeto de erro OLE DB.

Sintaxe

STDMETHOD(AddErrorRecord )(ERRORINFO *pErrorInfo,
   DWORD dwLookupID,
   DISPPARAMS *pdispparams,
   IUnknown *punkCustomError,
   DWORD dwDynamicErrorID);

Parâmetros

Confira IErrorRecords::AddErrorRecord na Referência do Programador do OLE DB.

IErrorRecordsImpl::GetBasicErrorInfo

Retorna informações básicas sobre o erro, como o código de retorno e o número do erro específico do provedor.

Sintaxe

STDMETHOD(GetBasicErrorInfo )(ULONG ulRecordNum,
   ERRORINFO *pErrorInfo);

Parâmetros

Confira IErrorRecords::GetBasicErrorInfo na Referência do Programador do OLE DB.

IErrorRecordsImpl::GetCustomErrorObject

Retorna um ponteiro para uma interface em um objeto de erro personalizado.

Sintaxe

STDMETHOD(GetCustomErrorObject )(ULONG ulRecordNum,
   REFIID riid,
   IUnknown **ppObject);

Parâmetros

Confira IErrorRecords::GetCustomErrorObject na Referência do Programador do OLE DB.

IErrorRecordsImpl::GetErrorInfo

Retorna um ponteiro de interface IErrorInfo no registro especificado.

Sintaxe

STDMETHOD(GetErrorInfo )(ULONG ulRecordNum,
   LCID lcid,
   IErrorInfo **ppErrorInfo);

Parâmetros

Confira IErrorRecords::GetErrorInfo na Referência do Programador do OLE DB.

IErrorRecordsImpl::GetErrorParameters

Retorna os parâmetros de erro.

Sintaxe

STDMETHOD(GetErrorParameters )(ULONG ulRecordNum,
   DISPPARAMS *pdispparams);

Parâmetros

Confira IErrorRecords::GetErrorParameters na Referência do Programador do OLE DB.

IErrorRecordsImpl::GetRecordCount

Retorna o número de registros no objeto de registro OLE DB.

Sintaxe

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Parâmetros

Confira IErrorRecords::GetRecordCount na Referência do Programador do OLE DB.

IErrorRecordsImpl::m_rgErrors

Uma matriz de registros de erro.

Sintaxe

CAtlArray< RecordClass > m_rgErrors;

Confira também

Modelos de Provedor OLE DB
Arquitetura de modelo do provedor do OLE DB