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.
| Code de retour | Description |
|---|---|
|
Aucun verbe n’est inscrit pour la classe. |
|
Aucun CLSID n’est inscrit pour l’objet de classe. |
|
Une erreur s’est produite lors de la lecture du Registre. |
|
La clé DataFormats/GetSet est manquante dans le Registre. |
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
| 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 | 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) |