OleRegGetMiscStatus, fonction (ole2.h)

Article
08/25/2023

Retourne diverses informations sur la présentation et les comportements pris en charge par le CLSID spécifié à partir du Registre.

Cette fonction est utilisée par les développeurs d’applications objet DLL personnalisées pour émuler le comportement du gestionnaire OLE par défaut.

Syntaxe

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Paramètres

[in] clsid

CLSID de la classe pour laquelle status informations doivent être demandées.

[in] dwAspect

Aspect de présentation de la classe pour laquelle des informations sont demandées. Les valeurs possibles sont extraites de l’énumération DVASPECT .

[out] pdwStatus

Pointeur vers la variable qui reçoit les informations status.

Valeur retournée

Cette fonction peut retourner la valeur de retour standard E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Les informations status ont été retournées avec succès.
REGDB_E_CLASSNOTREG	Aucun CLSID n’est inscrit pour l’objet de classe.
REGDB_E_READREGDB	Une erreur s’est produite lors de la lecture à partir du Registre.
OLE_E_REGDB_KEY	La clé GetMiscStatus est manquante dans le Registre.

Notes

Les applications objet peuvent demander à OLE d’obtenir diverses informations status de deux façons. Une méthode consiste à appeler OleRegGetMiscStatus. L’autre consiste à retourner OLE_S_USEREG en réponse aux appels du gestionnaire d’objets par défaut à IOleObject::GetMiscStatus. OLE_S_USEREG indique au gestionnaire par défaut d’appeler OleRegGetMiscStatus. Étant donné que les applications d’objet DLL ne peuvent pas retourner OLE_S_USEREG, elles doivent appeler OleRegGetMiscStatus au lieu de déléguer le travail au gestionnaire d’objets.

OleRegGetMiscStatus et ses fonctions frères, OleRegGetUserType, OleRegEnumFormatEtc et OleRegEnumVerbs, permettent aux développeurs d’applications d’objets DLL personnalisées d’émuler le comportement du gestionnaire d’objets par défaut d’OLE pour obtenir des informations sur les objets à partir du Registre. En utilisant ces fonctions, vous évitez le travail considérable d’écriture des vôtres et les pièges inhérents au travail directement dans le registre. En outre, vous bénéficiez d’améliorations et d’optimisations futures de ces fonctions sans avoir à les coder vous-même.

Spécifications


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	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType

Partager via