Método IComponentData::QueryDataObject (mmc.h)

Artigo
02/29/2024

O método IComponentData::QueryDataObject retorna um objeto de dados que pode ser usado para recuperar as informações de contexto do cookie especificado.

Sintaxe

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

Parâmetros

[in] cookie

Um valor que especifica o identificador exclusivo para o qual o objeto de dados é necessário.

[in] type

Um valor que especifica o objeto de dados como um dos seguintes:

CCT_SCOPE = 0x8000

Objeto de dados para o painel de escopo.

CCT_RESULT = 0x8001

Objeto de dados para o painel de resultados.

CCT_SNAPIN_MANAGER = 0x8002

Objeto de dados para o contexto do Gerenciador de Snap-In.

CCT_UNINITIALIZED = 0xFFFF

O objeto de dados tem um tipo inválido.

Essas constantes são membros da enumeração DATA_OBJECT_TYPES .

[out] ppDataObject

Um ponteiro para o endereço do objeto de dados retornado.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Você pode passar esses objetos de dados para o mesmo snap-in ou para snap-ins de extensão que os exigem. Algumas das interfaces do MMC que podem usar esse objeto de dados são IComponent, IComponentData, IContextMenuProvider, IExtendContextMenu, IExtendPropertySheet2 e IPropertySheetProvider.