IComponentData2::QueryDispatch-Methode (mmc.h)

Die QueryDispatch-Methode gibt die IDispatch-Schnittstelle des Snap-Ins für ein angegebenes Element zurück. MMC macht diese Schnittstelle über das MMC 2.0 Automation-Objektmodell verfügbar. Skripts oder andere Anwendungen können über die View.SnapinScopeObject- und View.SnapinSelectionObject-Methoden auf die IDispatch-Schnittstelle für das durch das angegebene Cookie dargestellte Element zugreifen.

Syntax

HRESULT QueryDispatch(
  [in]  MMC_COOKIE        cookie,
  [in]  DATA_OBJECT_TYPES type,
  [out] LPDISPATCH        *ppDispatch
);

Parameter

[in] cookie

Ein Wert, der das Kontextelement (oder die Elemente) angibt, für das die IDispatch-Schnittstelle angefordert wird. Der Cookiewert wird zuvor vom Snap-In bereitgestellt, und MMC verwendet ihn in diesem Methodenaufruf.

[in] type

Ein Wert, der das Datenobjekt als einen der folgenden konstanten Werte angibt, die Member der DATA_OBJECT_TYPES-Enumeration sind.

CCT_SCOPE = 0x8000

Datenobjekt für den Bereich.

CCT_RESULT = 0x8001

Datenobjekt für den Ergebnisbereich.

[out] ppDispatch

Dispatch-Schnittstellenzeiger. Das Snap-In legt *ppDispatch auf die IDispatch-Schnittstelle fest, die dem Cookiewert entspricht.

Rückgabewert

Bei erfolgreicher Ausführung wird der Rückgabewert S_OK. Andere Rückgabewerte weisen auf einen Fehlercode hin.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h

Weitere Informationen

View.SnapinScopeObject

View.SnapinSelectionObject