Método IPropertySheetProvider::Show (mmc.h)
Si el tipo que se ha establecido en IPropertySheetProvider::CreatePropertySheet es una hoja de propiedades, IPropertySheetProvider::Show muestra un marco de hoja de propiedades primario en una ventana oculta. Si el tipo que se ha establecido en IPropertySheetProvider::CreatePropertySheet es un asistente, IPropertySheetProvider::Show muestra un marco de hoja de propiedades primario al identificador que se pasa a este método.
Sintaxis
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
Parámetros
[in] window
Valor que especifica el identificador de la ventana primaria.
[in] page
Valor que especifica qué página de la hoja de propiedades se muestra. Está indizado a cero.
Valor devuelto
Este método puede devolver uno de estos valores.
Comentarios
IPropertySheetProvider::Show( –1, 0) devuelve E_FAIL. Este código de retorno se puede omitir en este caso.
En situaciones en las que el complemento crea una hoja de propiedades en una llamada a IPropertySheetProvider::CreatePropertySheet, llama opcionalmente a IPropertySheetProvider::AddPrimaryPages e IPropertySheetProvider::AddExtensionPages y, a continuación, decide no mostrar la hoja de propiedades, debe llamar a IPropertySheetProvider::Show( –1, 0) para eliminar la hoja de propiedades y liberar sus recursos. En este caso, el complemento debe eliminar los identificadores de la página de propiedades que ha creado. Esto se puede hacer antes o después de que el complemento llame a IPropertySheetProvider::Show( –1, 0), porque MMC no usa los identificadores de página de propiedades.
IPropertySheetProvider::Show( –1, 0) solo elimina la hoja de propiedades actual, es decir, una que se ha creado, pero aún no se muestra. Una vez que se muestra una hoja de propiedades, el complemento no puede cerrarlo mediante programación. Solo el usuario puede cerrar una hoja de propiedades que se muestra. En este caso, MMC elimina automáticamente todas las páginas de propiedades asociadas (estructuras PROPSHEETPAGE ) proporcionadas por el complemento.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |
| Archivo DLL | Mmcndmgr.dll |