Méthode IComponent2 ::QueryDispatch (mmc.h)
La méthode QueryDispatch retourne l’interface IDispatch du composant logiciel enfichable pour un élément spécifié. MMC expose cette interface via le modèle objet Automation MMC 2.0. Le script ou d’autres applications peuvent accéder à l’interface IDispatch pour l’élément représenté par le cookie spécifié via les méthodes View.SnapinScopeObject et View.SnapinSelectionObject .
Syntaxe
HRESULT QueryDispatch(
[in] MMC_COOKIE cookie,
[in] DATA_OBJECT_TYPES type,
[out] LPDISPATCH *ppDispatch
);
Paramètres
[in] cookie
Valeur qui spécifie l’élément de contexte (ou les éléments) pour lequel l’interface IDispatch est demandée. La valeur du cookie est précédemment fournie par le composant logiciel enfichable et MMC l’utilise dans cet appel de méthode.
[in] type
Valeur qui spécifie l’objet de données comme l’une des valeurs constantes suivantes, qui sont membres de l’énumération DATA_OBJECT_TYPES .
CCT_SCOPE = 0x8000
Objet de données pour le volet d’étendue.
CCT_RESULT = 0x8001
Objet de données pour le volet de résultats.
[out] ppDispatch
Pointeur d’interface de répartition. Le composant logiciel enfichable définit *ppDispatch sur l’interface IDispatch qui correspond à la valeur de cookie.
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.
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 |