IOleObject ::GetMiscStatus, méthode (oleidl.h)

Article
03/01/2024

Récupère la status d’un objet lors de la création et du chargement.

Syntaxe

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

Paramètres

[in] dwAspect

Aspect d’un objet sur lequel status informations sont demandées. La valeur est obtenue à partir de l’énumération DVASPECT.

[out] pdwStatus

Pointeur vers l'emplacement où les informations d'état sont retournées. Ce paramètre ne peut pas être NULL.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
OLE_S_USEREG	Déléguer la récupération de diverses informations status à l’implémentation de cette méthode par le gestionnaire par défaut.
CO_E_CLASSNOTREG	Aucun CLSID n’est inscrit pour l’objet .
CO_E_READREGDB	Erreur lors de l’accès au registre.

Remarques

Un conteneur appelle normalement IOleObject ::GetMiscStatus lorsqu’il crée ou charge un objet afin de déterminer comment afficher l’objet et les types de comportements qu’il prend en charge.

Les objets stockent status informations dans le Registre. Si l’objet n’est pas en cours d’exécution, l’implémentation du gestionnaire par défaut de IOleObject ::GetMiscStatus récupère ces informations à partir du Registre. Si l’objet est en cours d’exécution, le gestionnaire par défaut appelle IOleObject ::GetMiscStatus sur l’objet lui-même.

Les informations réellement stockées dans le registre varient selon les objets individuels. Les valeurs status à retourner sont définies dans l’énumération OLEMISC.

La valeur par défaut de IOleObject ::GetMiscStatus est utilisée si une sous-clé correspondant au DVASPECT spécifié est introuvable. Pour définir un contrôle OLE, spécifiez DVASPECT==1. Les éléments suivants se produisent alors dans le Registre :

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Remarques aux implémenteurs

L’implémentation consiste normalement à déléguer l’appel au gestionnaire par défaut.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h