Classe IErrorRecordsImpl

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 de contexto da ajuda de um registro de erro.
GetErrorHelpFile Obtém o nome de caminho completo do arquivo de ajuda de um registro de erro.
GetError Obtém o código-fonte do 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 de 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 ERRORINFO registro em uma IErrorInfo interface.

Valor Retornado

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 ERRORINFO registro em uma IErrorInfo interface.

Valor Retornado

Uma referência a um GUID para o erro.

IErrorRecordsImpl::GetErrorHelpContext

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

Sintaxe

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Parâmetros

rCurError
Um ERRORINFO registro em uma IErrorInfo interface.

Valor Retornado

A ID de contexto da 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 ERRORINFO registro em uma IErrorInfo interface.

Valor Retornado

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 ERRORINFO registro em uma IErrorInfo interface.

Valor Retornado

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

Consulte IErrorRecords:: AddErrorRecord na referência do programador de OLE DB.

IErrorRecordsImpl::GetBasicErrorInfo

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

Sintaxe

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

Parâmetros

Consulte IErrorRecords:: GetBasicErrorInfo na referência do programador de 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

Consulte IErrorRecords::GetCustomErrorObjectna Referência OLE DB programador.

IErrorRecordsImpl::GetErrorInfo

Retorna um ponteiro de interface IErrorInfo no registro especificado.

Sintaxe

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

Parâmetros

Consulte IErrorRecords::GetErrorInfona OLE DB do programador.

IErrorRecordsImpl::GetErrorParameters

Retorna os parâmetros de erro.

Sintaxe

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

Parâmetros

Consulte IErrorRecords::GetErrorParametersOLE DB referência do programador.

IErrorRecordsImpl::GetRecordCount

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

Sintaxe

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Parâmetros

Consulte IErrorRecords::GetRecordCountOLE DB Referência do programador.

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 OLE DB provedor de serviços