Compartilhar via


Método IConsoleNameSpace2::Expand (mmc.h)

O método IConsoleNameSpace2::Expand permite que o snap-in expanda um item no namespace sem expandir visivelmente o item no painel de escopo.

Sintaxe

HRESULT Expand(
  [in] HSCOPEITEM hItem
);

Parâmetros

[in] hItem

Um identificador para o item a ser expandido.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

IConsoleNameSpace2::Expand deve ser usado para expandir um item especificado com a finalidade de enumerar os itens filho desse item. Lembre-se de que você deve chamar IConsoleNameSpace2::Expand antes de inserir um item como um item filho no painel de escopo.

Por exemplo, se um snap-in precisar colocar um item filho abaixo de um item pai em uma posição específica (como a parte superior de uma lista de itens filho), o snap-in deverá usar esse método para expandir o item para encontrar a posição exata na qual colocar um item filho. O snap-in também pode usar esse método para chamar IConsoleNameSpace2::GetChildItem em um item filho de um item que não foi expandido (seja por uma chamada anterior para IConsoleNameSpace2::Expand ou pelo usuário clicando no sinal de adição no painel de escopo) para expandir esse item com a finalidade de enumerar seus filhos.

IConsoleNameSpace2::Expand não expande visivelmente o item na árvore exibida no painel de escopo no console. Um snap-in usa IConsole2::Expand para expandir ou recolher visivelmente um item no painel de escopo. Esse método envia uma notificação de MMCN_EXPAND para IComponentData se e somente se o item não tiver sido expandido anteriormente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IConsoleNameSpace2