GetErrorInfo, fonction (oleauto.h)

Article
03/04/2024

Obtient le pointeur d’informations d’erreur défini par l’appel précédent à SetErrorInfo dans le thread logique actuel.

Syntaxe

HRESULT GetErrorInfo(
  [in]  ULONG      dwReserved,
  [out] IErrorInfo **pperrinfo
);

Paramètres

[in] dwReserved

Réservé pour un usage futur. Doit être zéro.

[out] pperrinfo

Objet d’erreur.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Opération réussie.
S_FALSE	Il n’y avait aucun objet d’erreur à retourner.

Remarques

Cette fonction retourne un pointeur vers le dernier pointeur IErrorInfo défini dans le thread logique actuel. Il transfère la propriété de l’objet d’erreur à l’appelant et efface l’état d’erreur du thread.

L’exécution d’un appel COM qui passe par un proxy-stub efface tout objet d’erreur existant pour le thread appelant. Un objet appelé ne doit pas effectuer de tels appels après l’appel de SetErrorInfo et avant le retour. L’appelant ne doit pas effectuer de tels appels après le retour de l’appel et avant d’appeler GetErrorInfo. En règle générale, une méthode d’interface doit être retournée dès que possible après l’appel de SetErrorInfo, et l’appelant doit appeler GetErrorInfo dès que possible après le retour de l’appel.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	oleauto.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll