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
Members (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 case activée 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour