Compartilhar via


Estrutura SMMCObjectTypes (mmc.h)

A estrutura SMMCDynamicExtensions é introduzida no MMC 1.1.

A estrutura SMMCDynamicExtensions define o formato dos dados para o formato da área de transferência CCF_MMC_DYNAMIC_EXTENSIONS, que especifica os snap-ins de extensão não namespace que devem estender um escopo ou item de resultado.

Sintaxe

typedef struct _SMMCObjectTypes {
  DWORD count;
  GUID  guid[1];
} SMMCObjectTypes;

Membros

count

A contagem de GUIDs na matriz especificada pelo guid.

guid[1]

Uma matriz de GUIDs que representam os CLSIDs dos snap-ins que você deseja estender o item representado por um objeto IDataObject .

Comentários

Para que um snap-in dê suporte à extensão dinâmica de seus itens com extensões não namespace (ou seja, menu de contexto, barra de ferramentas, folha de propriedades ou extensões do bloco de tarefas), o formato da área de transferência CCF_MMC_DYNAMIC_EXTENSIONS deve ser tratado na implementação IDataObject do snap-in. Para obter mais informações, consulte Extensões dinâmicas sem namespace.

Lembre-se de que o snap-in de extensão deve ser uma extensão que não seja de namespace e as entradas do Registro do MMC para que o snap-in seja estendido, bem como o snap-in de extensão deve ser definido corretamente. Para obter detalhes sobre como definir entradas do Registro do MMC para extensões, consulte Requisitos de registro para snap-ins de extensão.

O formato da área de transferência CCF_MMC_DYNAMIC_EXTENSIONS estende apenas extensões não namespace. Para adicionar dinamicamente extensões de namespace, o snap-in deve usar o método IConsoleNameSpace2::AddExtension . Para obter mais informações, consulte Extensões de namespace dinâmico.

Pouco antes de o MMC usar um recurso extensível (ou seja, pouco antes de criar e que exibe um menu de contexto, folha de propriedades, barra de ferramentas ou painel de tarefas), o MMC chama IDataObject::GetDataHere no objeto de dados do item selecionado e solicita que extensões dinâmicas sejam adicionadas por meio do formato de área de transferência CCF_MMC_DYNAMIC_EXTENSIONS. Com base em CLSIDs passados na estrutura SMMCDynamicExtensions , o MMC tenta adicionar as extensões especificadas ao recurso extensível. Se uma extensão não estiver disponível ou não registrada, o MMC ignorará essa extensão e continuará para o próximo CLSID passado na estrutura.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Cabeçalho mmc.h

Confira também

CCF_MMC_DYNAMIC_EXTENSIONS

IConsoleNameSpace2::AddExtension

SMMCObjectTypes