Compartir a través de

IErrorRecordsImpl (Clase)

  • Artículo

Implementa la interfaz IErrorRecords de OLE DB, agregando registros a un miembro de datos y recuperando registros de un miembro de datos (m_rgErrors) de tipo CAtlArray<RecordClass>.

Sintaxis

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

Parámetros

T
Una clase derivada de IErrorRecordsImpl.

RecordClass
Clase que representa un objeto de error OLE DB.

Requisitos

Encabezado: atldb.h

Miembros

Métodos

Nombre Descripción
GetErrorDescriptionString Obtiene la cadena de descripción del error de un registro de error.
GetErrorGUID Obtiene el GUID de error de un registro de error.
GetErrorHelpContext Obtiene el identificador de contexto de ayuda de un registro de error.
GetErrorHelpFile Obtiene el nombre de ruta de acceso completo del archivo de ayuda de un registro de error.
GetErrorSource Obtiene el código fuente del error de un registro de error.

Métodos de interfaz

Nombre Descripción
AddErrorRecord Agrega un registro al objeto de error OLE DB.
GetBasicErrorInfo Devuelve información básica sobre el error, como el código de retorno y el número de error específico del proveedor.
GetCustomErrorObject Devuelve un puntero a una interfaz en un objeto de error personalizado.
GetErrorInfo Devuelve un puntero de interfaz IErrorInfo en el registro especificado.
GetErrorParameters Devuelve los parámetros de error.
GetRecordCount Devuelve el número de registros del objeto de registro OLE DB.

Miembros de datos

Nombre Descripción
m_rgErrors Matriz de registros de error.

IErrorRecordsImpl::GetErrorDescriptionString

Obtiene la cadena de descripción del error de un registro de error.

Sintaxis

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

Parámetros

rCurError
Un registro ERRORINFO en una interfaz IErrorInfo.

Valor devuelto

Puntero a una cadena que describe el error.

IErrorRecordsImpl::GetErrorGUID

Obtiene el GUID de error de un registro de error.

Sintaxis

REFGUID GetErrorGUID(ERRORINFO& rCurError);

Parámetros

rCurError
Un registro ERRORINFO en una interfaz IErrorInfo.

Valor devuelto

Referencia a un GUID para el error.

IErrorRecordsImpl::GetErrorHelpContext

Obtiene el identificador de contexto de ayuda de un registro de error.

Sintaxis

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Parámetros

rCurError
Un registro ERRORINFO en una interfaz IErrorInfo.

Valor devuelto

Identificador de contexto de ayuda para el error.

IErrorRecordsImpl::GetErrorHelpFile

Obtiene el nombre de ruta de acceso del archivo de ayuda de un registro de error.

Sintaxis

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

Parámetros

rCurError
Un registro ERRORINFO en una interfaz IErrorInfo.

Valor devuelto

Puntero a una cadena que contiene el nombre de la ruta de acceso del archivo de ayuda para el error.

IErrorRecordsImpl::GetErrorSource

Obtiene el código fuente que provocó el error de un registro de error.

Sintaxis

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

Parámetros

rCurError
Un registro ERRORINFO en una interfaz IErrorInfo.

Valor devuelto

Puntero a una cadena que contiene el código fuente del error.

IErrorRecordsImpl::AddErrorRecord

Agrega un registro al objeto de error OLE DB.

Sintaxis

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

Parámetros

Vea IErrorRecords::AddErrorRecord en la Referencia del programador de OLE DB.

IErrorRecordsImpl::GetBasicErrorInfo

Devuelve información básica sobre el error, como el código de retorno y el número de error específico del proveedor.

Sintaxis

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

Parámetros

Vea IErrorRecords::GetBasicErrorInfo en la Referencia del programador de OLE DB.

IErrorRecordsImpl::GetCustomErrorObject

Devuelve un puntero a una interfaz en un objeto de error personalizado.

Sintaxis

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

Parámetros

Vea IErrorRecords::GetCustomErrorObject en la Referencia del programador de OLE DB.

IErrorRecordsImpl::GetErrorInfo

Devuelve un puntero de interfaz IErrorInfo en el registro especificado.

Sintaxis

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

Parámetros

Vea IErrorRecords::GetErrorInfo en la Referencia del programador de OLE DB.

IErrorRecordsImpl::GetErrorParameters

Devuelve los parámetros de error.

Sintaxis

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

Parámetros

Vea IErrorRecords::GetErrorParameters en la Referencia del programador de OLE DB.

IErrorRecordsImpl::GetRecordCount

Devuelve el número de registros del objeto de registro OLE DB.

Sintaxis

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Parámetros

Vea IErrorRecords::GetRecordCount en la Referencia del programador de OLE DB.

IErrorRecordsImpl::m_rgErrors

Matriz de registros de error.

Sintaxis

CAtlArray< RecordClass > m_rgErrors;

Consulte también

Plantillas de proveedores OLE DB
Arquitectura de plantillas de proveedores OLE DB