OleRegEnumVerbs, fonction (ole2.h)

Fournit une énumération des verbes inscrits pour la classe spécifiée. Les développeurs d’applications d’objets DLL personnalisées utilisent cette fonction pour émuler le comportement du gestionnaire d’objets par défaut.

Syntaxe

HRESULT OleRegEnumVerbs(
  [in]  REFCLSID      clsid,
  [out] LPENUMOLEVERB *ppenum
);

Paramètres

[in] clsid

Identificateur de classe dont les verbes sont demandés.

[out] ppenum

Adresse de la variable de pointeur IEnumOLEVERB* qui reçoit le pointeur d’interface vers le nouvel objet d’énumération.

Valeur retournée

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

Remarques

Les applications d’objet peuvent demander à OLE de créer un objet d’énumération pour les structures OLEVERB afin d’énumérer les verbes pris en charge de deux manières. L’une des façons consiste à appeler OleRegEnumVerbs. L’autre méthode consiste à retourner OLE_S_USEREG en réponse aux appels du gestionnaire d’objets par défaut à IOleObject ::EnumVerbs. OLE_S_USEREG indique au gestionnaire par défaut d’appeler OleRegEnumVerbs. Étant donné que les applications d’objet DLL ne peuvent pas retourner OLE_S_USEREG, elles doivent appeler OleRegEnumVerbs au lieu de déléguer le travail au gestionnaire d’objets. Avec le pointeur IEnumOLEVERB fourni vers l’objet, vous pouvez appeler les méthodes d’objet d’énumération standard pour effectuer l’énumération.

La fonction OleRegEnumVerbs et ses fonctions frères OleRegGetUserType, OleRegGetMiscStatus et OleRegEnumFormatEtc permettent aux développeurs d’applications d’objet 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.

Configuration requise

Voir aussi

IEnumOLEVERB

IOleObject ::EnumVerbs