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
| Nom | Description |
|---|---|
| GetAllErrorInfo | Retourne toutes les informations d’erreur contenues dans un enregistrement d’erreur. |
| GetBasicErrorInfo | Appelle IErrorRecords ::GetBasicErrorInfo pour retourner des informations de base sur l’erreur spécifiée. |
| GetCustomErrorObject | Appelle IErrorRecords ::GetCustomErrorObject pour renvoyer un pointeur vers une interface sur un objet d’erreur personnalisé. |
| GetErrorInfo | Appelle IErrorRecords ::GetErrorInfo pour retourner un pointeur d’interface IErrorInfo vers l’enregistrement spécifié. |
| GetErrorParameters | Appelle IErrorRecords ::GetErrorParameters pour retourner les paramètres d’erreur. |
| GetErrorRecords | Obtient les enregistrements d’erreur de l’objet spécifié. |
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 si elle réussit. 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 :
la valeur de lcid n’est PAS lcid anglais et
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