Método IConsole2::Expand (mmc.h)
El método IConsole2::Expand permite al complemento expandir o contraer un elemento en el panel de ámbito.
Sintaxis
HRESULT Expand(
[in] HSCOPEITEM hItem,
[in] BOOL bExpand
);
Parámetros
[in] hItem
Identificador del elemento que se va a expandir.
[in] bExpand
Valor que especifica si se va a expandir o contraer el elemento. TRUE expande el elemento. FALSE contrae el elemento.
Valor devuelto
Este método puede devolver uno de estos valores.
Comentarios
El método IConsole2::Expand es el equivalente mediante programación del usuario que hace clic en el signo más o menos para expandir o contraer un elemento en el panel de ámbito. Es decir, este método provoca una expansión o un colapso visibles de un elemento en el panel de ámbito. Tenga en cuenta que este método no cambia la selección en el panel de ámbito y no afecta al panel de resultados.
Cuando se llama a este método, MMC expande o contrae el elemento especificado por hItem según el valor establecido para bExpand. A continuación, MMC envía una notificación de expansión al complemento de cada elemento secundario. MMC lo hace llamando al método IComponentData::Notify del complemento secundario con el conjunto de eventos en MMCN_EXPAND, lpDataObject establecido como puntero al objeto de datos para hItem, arg establecido como TRUE o FALSE en función de bExpand y param establecido como hItem. Tenga en cuenta que hItem es el identificador HSCOPEITEM que especificó en la llamada a IConsole2::Expand.
El método IConsole2::Expand solo se aplica a una vista determinada. Esto significa que solo se aplica a la instancia del objeto IComponent del complemento que corresponde al elemento de complemento que aparece en una ventana de interfaz de varios documentos (MDI) específica dentro de la consola. Tenga en cuenta que cada ventana MDI de la consola representa una vista diferente y que una instancia de un complemento dentro de una ventana MDI corresponde a un objeto IComponent para ese complemento.
Por lo tanto, el complemento solo debe llamar a este método en el puntero de interfaz IConsole2 asociado a un objeto IComponent , es decir, un puntero de interfaz IConsole2 recuperado llamando a QueryInterface en el puntero de interfaz IConsole devuelto por IComponent::Initialize.
Para enumerar los elementos secundarios de un elemento en el espacio de nombres sin expandir visiblemente el elemento, el complemento debe usar el método IConsoleNameSpace2::Expand .
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |
| Archivo DLL | Mmcndmgr.dll |