CDBErrorInfo, classe

Prend en charge le traitement des erreurs OLE DB à l’aide de l’interface OLE DB IErrorRecords .

Syntaxe

class CDBErrorInfo

Spécifications

En-tête : atldbcli.h

Membres

Méthodes

Notes

Cette interface retourne un ou plusieurs enregistrements d’erreur à l’utilisateur. Appelez D’abord CDBErrorInfo ::GetErrorRecords pour obtenir le nombre d’enregistrements d’erreurs. Appelez ensuite l’une des fonctions d’accès, telles que CDBErrorInfo ::GetAllErrorInfo, pour récupérer les informations d’erreur pour chaque enregistrement.

CDBErrorInfo::GetAllErrorInfo

Retourne tous les types d’informations d’erreur contenus dans un enregistrement d’erreur.

Syntaxe

HRESULT GetAllErrorInfo(ULONG ulRecordNum,
   LCID lcid,  BSTR* pbstrDescription,
   BSTR* pbstrSource = NULL,
   GUID* pguid = NULL,
   DWORD* pdwHelpContext = NULL,
   BSTR* pbstrHelpFile = NULL) const throw();

Paramètres

ulRecordNum
[in] Nombre de base zéro de l’enregistrement pour lequel retourner des informations d’erreur.

lcid
[in] ID de paramètres régionaux pour les informations d’erreur à renvoyer.

pbstrDescription
[out] Pointeur vers une description textuelle de l’erreur ou NULL si les paramètres régionaux ne sont pas pris en charge. Consultez la section Notes.

pbstrSource
[out] Pointeur vers une chaîne contenant le nom du composant qui a généré l’erreur.

pguid
[out] Pointeur vers le GUID de l’interface qui a défini l’erreur.

pdwHelpContext
[out] Pointeur vers l’ID de contexte d’aide pour l’erreur.

pbstrHelpFile
[out] Pointeur vers une chaîne contenant le chemin d’accès au fichier d’aide qui décrit l’erreur.

Valeur de retour

S_OK en cas de réussite. Consultez IErrorRecords ::GetErrorInfo dans la référence du programmeur OLE DB pour obtenir d’autres valeurs de retour.

Notes

La valeur de sortie de pbstrDescription est obtenue en interne en appelant IErrorInfo::GetDescription, qui définit la valeur NULL si les paramètres régionaux ne sont pas pris en charge, ou si les deux conditions suivantes sont remplies :

1. la valeur de lcid n’est PAS lcid anglais et

2. la valeur de lcid n’est PAS égale à la valeur retournée par GetUserDefaultLCID.

CDBErrorInfo::GetBasicErrorInfo

Appelle IErrorRecords ::GetBasicErrorInfo pour retourner des informations de base sur l’erreur, telles que le code de retour et le numéro d’erreur spécifique au fournisseur.

Syntaxe

HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
   ERRORINFO* pErrorInfo) const throw();

Paramètres

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

Valeur de retour

HRESULT standard.

CDBErrorInfo::GetCustomErrorObject

Appelle IErrorRecords ::GetCustomErrorObject pour renvoyer un pointeur vers une interface sur un objet d’erreur personnalisé.

Syntaxe

HRESULT GetCustomErrorObject(ULONG ulRecordNum,
   REFIID riid,IUnknown** ppObject) const throw();

Paramètres

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

Valeur de retour

HRESULT standard.

CDBErrorInfo::GetErrorInfo

Appelle IErrorRecords ::GetErrorInfo pour retourner un pointeur d’interface IErrorInfo vers l’enregistrement spécifié.

Syntaxe

HRESULT GetErrorInfo(ULONG ulRecordNum,
   LCID lcid,IErrorInfo** ppErrorInfo) const throw();

Paramètres

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

Valeur de retour

HRESULT standard.

CDBErrorInfo::GetErrorParameters

Appelle IErrorRecords ::GetErrorParameters pour retourner les paramètres d’erreur.

Syntaxe

HRESULT GetErrorParameters(ULONG ulRecordNum,
   DISPPARAMS* pdispparams) const throw();

Paramètres

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

Valeur de retour

HRESULT standard.

CDBErrorInfo::GetErrorRecords

Obtient les enregistrements d’erreur de l’objet spécifié.

Syntaxe

HRESULT GetErrorRecords(IUnknown* pUnk,
   const IID& iid,
   ULONG* pcRecords) throw();

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Paramètres

punk
[in] Interface vers l’objet pour lequel obtenir des enregistrements d’erreur.

iid
[in] IID de l’interface associée à l’erreur.

pcRecords
[out] Pointeur vers le nombre (basé sur un) d’enregistrements d’erreur.

Valeur de retour

HRESULT standard.

Notes

Utilisez la première forme de la fonction si vous souhaitez vérifier l’interface à partir de laquelle obtenir les informations d’erreur. Sinon, utilisez le deuxième formulaire.

Voir aussi

DBViewer
Modèles du consommateur OLE DB
Référence des modèles du consommateur OLE DB