IComponentData::QueryDataObject method (mmc.h)

The IComponentData::QueryDataObject method returns a data object that can be used to retrieve the context information for the specified cookie.

Syntax

HRESULT QueryDataObject(
  [in]  MMC_COOKIE        cookie,
  [in]  DATA_OBJECT_TYPES type,
  [out] LPDATAOBJECT      *ppDataObject
);

Parameters

[in] cookie

A value that specifies the unique identifier for which the data object is required.

[in] type

A value that specifies the data object as one of the following:

CCT_SCOPE = 0x8000

Data object for the scope pane.

CCT_RESULT = 0x8001

Data object for the result pane.

CCT_SNAPIN_MANAGER = 0x8002

Data object for the Snap-In Manager context.

CCT_UNINITIALIZED = 0xFFFF

Data object has an invalid type.

These constants are members of the DATA_OBJECT_TYPES enumeration.

[out] ppDataObject

A pointer to the address of the returned data object.

Return value

This method can return one of these values.

Remarks

You can pass these data objects to the same snap-in or to extension snap-ins that require them. Some of the MMC interfaces that can use this data object are IComponent, IComponentData, IContextMenuProvider, IExtendContextMenu, IExtendPropertySheet2, and IPropertySheetProvider.

Requirements

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

See also

IComponent

IComponentData

IConsole2

IDataObject