IComponent2 ::GetResultViewType2, méthode (mmc.h)
La méthode GetResultViewType2 récupère le type d’affichage des résultats. Cette méthode remplace la méthode IComponent ::GetResultViewType .
Syntaxe
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
Paramètres
[in] cookie
Valeur qui spécifie l’identificateur unique fourni par l’alignement pour l’élément d’étendue. Pour plus d’informations sur les cookies dans MMC, consultez Cookies.
[in, out] pResultViewType
Pointeur vers la structure RESULT_VIEW_TYPE_INFO pour la vue des résultats. Si votre composant logiciel enfichable implémente IComponent2, le membre pstrPersistableViewDescription de la structure RESULT_VIEW_TYPE_INFO doit contenir une chaîne de description d’affichage valide ; sinon, MMC n’initialise pas votre composant logiciel enfichable. Le membre pstrPersistableViewDescription doit être alloué par CoTaskMemAlloc. Le composant logiciel enfichable ne doit pas libérer pstrPersistableViewDescription, car il sera libéré par MMC.
Valeur retournée
En cas de réussite, la valeur de retour est S_OK. D’autres valeurs de retour indiquent un code d’erreur.
Remarques
Lors de la création de l’affichage des résultats, MMC appelle la méthode IComponent2 ::GetResultViewType2 du composant logiciel enfichable. Lorsque l’utilisateur revisite l’affichage des résultats nommé par le membre pstrPersistableViewDescription de *pResultViewType, MMC appelle la méthode IComponent2 ::RestoreResultView du composant logiciel enfichable, à partir de laquelle le composant logiciel enfichable peut fournir des détails spécifiques au composant logiciel enfichable (le cas échéant) pour l’affichage des résultats restaurés. L’utilisateur revisite la vue des résultats au moyen des boutons Précédent/Suivant de la console MMC ou du chargement d’un fichier de console enregistré. Pour plus d’informations sur l’utilisation des méthodes IComponent2 ::GetResultViewType2 et IComponent2 ::RestoreResultView , consultez Restauration des vues de résultats.
Si le composant logiciel enfichable implémente une vue OCX (contrôle ActiveX), le composant logiciel enfichable crée l’OCX et fournit à MMC le pointeur OCX IUnknown dans la structure RESULT_VIEW_TYPE_INFO (plus précisément, le membre pUnkControl de la structure). Le composant logiciel enfichable contrôle la création d’OCX, de sorte que le composant logiciel enfichable peut résoudre les problèmes de licence ou de sécurité en fonction des besoins. Pendant l’appel à GetResultViewType2, le composant logiciel enfichable peut également initialiser l’OCX (le composant logiciel enfichable ne recevra pas de notification MMCN_INITOCX ).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |