Metodo IConsole2::Expand (mmc.h)
Il metodo IConsole2::Expand consente allo snap-in di espandere o comprimere un elemento nel riquadro dell'ambito.
Sintassi
HRESULT Expand(
[in] HSCOPEITEM hItem,
[in] BOOL bExpand
);
Parametri
[in] hItem
Handle per l'elemento da espandere.
[in] bExpand
Valore che specifica se espandere o comprimere l'elemento. TRUE espande l'elemento. FALSE comprime l'elemento.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
Il metodo IConsole2::Expand è l'equivalente programmatico dell'utente che fa clic sul segno più o meno per espandere o comprimere un elemento nel riquadro dell'ambito. Ovvero, questo metodo causa un'espansione o un compressione visibile di un elemento nel riquadro dell'ambito. Tenere presente che questo metodo non modifica la selezione nel riquadro dell'ambito e non influisce sul riquadro dei risultati.
Quando viene chiamato questo metodo, MMC espande o comprime l'elemento specificato da hItem in base al valore impostato per bExpand. MMC invia quindi una notifica di espansione allo snap-in di ogni elemento figlio. MMC lo fa chiamando il metodo IComponentData::Notify di ogni snap-in figlio con evento impostato su MMCN_EXPAND, lpDataObject impostato come puntatore all'oggetto dati per hItem, arg impostato su TRUE o FALSE in base a bExpand e param impostato come hItem. Tenere presente che hItem è l'handle HSCOPEITEM specificato nella chiamata a IConsole2::Expand.
Il metodo IConsole2::Expand si applica solo a una visualizzazione specifica. Ciò significa che si applica solo all'istanza dell'oggetto IComponent dello snap-in corrispondente all'elemento snap-in visualizzato in una finestra MDI (Multiple Document Interface) specifica all'interno della console. Tenere presente che ogni finestra MDI all'interno della console rappresenta una visualizzazione diversa e che un'istanza di uno snap-in all'interno di una finestra MDI corrisponde a un oggetto IComponent per tale snap-in.
Di conseguenza, lo snap-in deve chiamare questo metodo solo sul puntatore dell'interfaccia IConsole2 associato a un oggetto IComponent , ovvero un puntatore all'interfaccia IConsole2 recuperato chiamando QueryInterface sul puntatore dell'interfaccia IConsole restituito da IComponent::Initialize.
Per enumerare gli elementi figlio di un elemento nello spazio dei nomi senza visibilmente espandere l'elemento, lo snap-in deve usare il metodo IConsoleNameSpace2::Expand .
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| DLL | Mmcndmgr.dll |