Partager via

IErrorRecordsImpl, classe

  • Article

Implémente l’interface OLE DB IErrorRecords, en ajoutant des enregistrements et en récupérant des enregistrements à partir d’un membre de données (m_rgErrors) de type CAtlArray<RecordClass>.

Syntaxe

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

Paramètres

T
Classe dérivée de IErrorRecordsImpl.

RecordClass
Classe qui représente un objet d’erreur OLE DB.

Spécifications

En-tête : atldb.h

Membres

Méthodes

Nom Description
GetErrorDescriptionString Obtient la chaîne de description d’erreur à partir d’un enregistrement d’erreur.
GetErrorGUID Obtient le GUID d’erreur à partir d’un enregistrement d’erreur.
GetErrorHelpContext Obtient l’ID de contexte d’aide à partir d’un enregistrement d’erreur.
GetErrorHelpFile Obtient le chemin d’accès complet du fichier d’aide à partir d’un enregistrement d’erreur.
GetErrorSource Obtient le code source d’erreur d’un enregistrement d’erreur.

Méthodes d'interface

Nom Description
AddErrorRecord Ajoute un enregistrement à l’objet d’erreur OLE DB.
GetBasicErrorInfo Retourne des informations de base sur l’erreur, telles que le code de retour et le numéro d’erreur spécifique au fournisseur.
GetCustomErrorObject Retourne un pointeur vers une interface sur un objet d’erreur personnalisé.
GetErrorInfo Retourne un pointeur d’interface IErrorInfo sur l’enregistrement spécifié.
GetErrorParameters Retourne les paramètres d’erreur.
GetRecordCount Retourne le nombre d’enregistrements dans l’objet d’enregistrement OLE DB.

Données membres

Nom Description
m_rgErrors Tableau d’enregistrements d’erreurs.

IErrorRecordsImpl::GetErrorDescriptionString

Obtient la chaîne de description d’erreur à partir d’un enregistrement d’erreur.

Syntaxe

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

Paramètres

rCurError
Enregistrement ERRORINFO dans une IErrorInfo interface.

Valeur de retour

Pointeur vers une chaîne décrivant l’erreur.

IErrorRecordsImpl::GetErrorGUID

Obtient le GUID d’erreur à partir d’un enregistrement d’erreur.

Syntaxe

REFGUID GetErrorGUID(ERRORINFO& rCurError);

Paramètres

rCurError
Enregistrement ERRORINFO dans une IErrorInfo interface.

Valeur de retour

Référence à un GUID pour l’erreur.

IErrorRecordsImpl::GetErrorHelpContext

Obtient l’ID de contexte d’aide à partir d’un enregistrement d’erreur.

Syntaxe

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Paramètres

rCurError
Enregistrement ERRORINFO dans une IErrorInfo interface.

Valeur de retour

ID de contexte d’aide pour l’erreur.

IErrorRecordsImpl::GetErrorHelpFile

Obtient le nom du chemin d’accès du fichier d’aide à partir d’un enregistrement d’erreur.

Syntaxe

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

Paramètres

rCurError
Enregistrement ERRORINFO dans une IErrorInfo interface.

Valeur de retour

Pointeur vers une chaîne qui contient le nom du chemin d’accès du fichier d’aide pour l’erreur.

IErrorRecordsImpl::GetErrorSource

Obtient le code source qui a provoqué l’erreur à partir d’un enregistrement d’erreur.

Syntaxe

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

Paramètres

rCurError
Enregistrement ERRORINFO dans une IErrorInfo interface.

Valeur de retour

Pointeur vers une chaîne contenant le code source de l’erreur.

IErrorRecordsImpl::AddErrorRecord

Ajoute un enregistrement à l’objet d’erreur OLE DB.

Syntaxe

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

Paramètres

Consultez IErrorRecords ::AddErrorRecord dans la référence du programmeur OLE DB.

IErrorRecordsImpl::GetBasicErrorInfo

Retourne des informations de base sur l’erreur, telles que le code de retour et le numéro d’erreur spécifique au fournisseur.

Syntaxe

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

Paramètres

Consultez IErrorRecords ::GetBasicErrorInfo dans la référence du programmeur OLE DB.

IErrorRecordsImpl::GetCustomErrorObject

Retourne un pointeur vers une interface sur un objet d’erreur personnalisé.

Syntaxe

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

Paramètres

Consultez IErrorRecords ::GetCustomErrorObject dans la référence du programmeur OLE DB.

IErrorRecordsImpl::GetErrorInfo

Retourne un pointeur d’interface IErrorInfo sur l’enregistrement spécifié.

Syntaxe

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

Paramètres

Consultez IErrorRecords ::GetErrorInfo dans la référence du programmeur OLE DB.

IErrorRecordsImpl::GetErrorParameters

Retourne les paramètres d’erreur.

Syntaxe

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

Paramètres

Consultez IErrorRecords ::GetErrorParameters dans la référence du programmeur OLE DB.

IErrorRecordsImpl::GetRecordCount

Retourne le nombre d’enregistrements dans l’objet d’enregistrement OLE DB.

Syntaxe

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Paramètres

Consultez IErrorRecords ::GetRecordCount dans la référence du programmeur OLE DB.

IErrorRecordsImpl::m_rgErrors

Tableau d’enregistrements d’erreurs.

Syntaxe

CAtlArray< RecordClass > m_rgErrors;

Voir aussi

Modèles du fournisseur OLE DB
Architecture des modèles du fournisseur OLE DB