Méthode IComponent2 ::RestoreResultView (mmc.h)
La méthode RestoreResultView restaure l’affichage des résultats. Cette méthode permet à un composant logiciel enfichable de restaurer les détails spécifiques au composant logiciel enfichable d’une vue de résultat. Pour plus d’informations, consultez Restauration des vues de résultats.
Cette méthode remplace l’utilisation de la notification MMCN_RESTORE_VIEW .
Syntaxe
HRESULT RestoreResultView(
[in] MMC_COOKIE cookie,
[in] PRESULT_VIEW_TYPE_INFO pResultViewType
);
Paramètres
[in] cookie
Valeur qui spécifie l’identificateur unique dont la vue des résultats sera restaurée.
[in] pResultViewType
Pointeur vers la structure RESULT_VIEW_TYPE_INFO pour la vue des résultats.
Valeur retournée
En cas de réussite, la valeur de retour est S_OK. Le composant logiciel enfichable peut retourner S_FALSE pour empêcher MMC de restaurer l’affichage en fonction des informations contenues dans *pResultViewType. D’autres valeurs de retour indiquent un code d’erreur.
Remarques
Le membre pstrPersistableViewDescription de *pResultViewType spécifie le nom attribué à la vue de résultats. Pour restaurer l’affichage des résultats identifié par le membre pstrPersistableViewDescription , le composant logiciel enfichable remplit les autres membres de *pResultViewType. Le nom de la vue des résultats est initialement attribué lors de l’implémentation du composant logiciel enfichable IComponent2 ::GetResultViewType2. MMC appelle IComponent2 ::RestoreResultView afin que le composant logiciel enfichable puisse restaurer les paramètres d’affichage internes lorsque l’affichage des résultats est revisité par l’utilisateur.
Lorsque l’utilisateur personnalise l’affichage, certains des paramètres (tels que les options d’affichage ou le mode d’affichage) sont connus par MMC, et d’autres (tels que le plus ancien premier du composant logiciel enfichable observateur d'événements) sont internes au composant logiciel enfichable. Avant MMC 2.0, il n’existait aucun mécanisme permettant à MMC de communiquer avec le composant logiciel enfichable pour restaurer les paramètres d’affichage interne. Les méthodes IComponent2 ::GetResultViewType2 et IComponent2 ::RestoreResultView dans MMC 2.0 fournissent toutefois le mécanisme de restauration des paramètres d’affichage internes. Le composant logiciel enfichable conserve les paramètres d’affichage internes par rapport au membre pstrPersistableViewDescription de la structure RESULT_VIEW_TYPE_INFO . Lorsque MMC appelle IComponent2 ::RestoreResultView pour restaurer l’affichage des résultats, le composant logiciel enfichable utilise les paramètres persistants pour terminer la restauration de l’affichage.
L’utilisateur revisite la vue des résultats en appuyant sur les boutons Précédent/Précédent de la console MMC ou en chargeant un fichier de console enregistré.
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 |