IComponent2::QueryDispatch method (mmc.h)

Article
02/22/2024

The QueryDispatch method returns the snap-in IDispatch interface for a specified item. MMC will expose this interface through the MMC 2.0 Automation object model. Script, or other applications, can access the IDispatch interface for the item represented by the specified cookie through the View.SnapinScopeObject and View.SnapinSelectionObject methods.

Syntax

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

Parameters

[in] cookie

A value that specifies the context item (or items) for which the IDispatch interface is requested. The cookie value is previously provided by the snap-in, and MMC uses it in this method call.

[in] type

A value that specifies the data object as one of the following constant values, which, are members of the DATA_OBJECT_TYPES enumeration.

CCT_SCOPE = 0x8000

Data object for the scope pane.

CCT_RESULT = 0x8001

Data object for the result pane.

[out] ppDispatch

A dispatch interface pointer. The snap-in sets *ppDispatch to the IDispatch interface that corresponds to the cookie value.

Return value

If successful, the return value is S_OK. Other return values indicate an error code.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	mmc.h

Share via