Metodo IPropertySheetProvider::Show (mmc.h)
Se il tipo impostato in IPropertySheetProvider::CreatePropertySheet è una finestra delle proprietà, IPropertySheetProvider::Show visualizza una cornice della finestra delle proprietà padre di una finestra nascosta. Se il tipo impostato in IPropertySheetProvider::CreatePropertySheet è una procedura guidata, IPropertySheetProvider::Show visualizza una cornice della finestra delle proprietà padre sull'handle passato a questo metodo.
Sintassi
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
Parametri
[in] window
Valore che specifica l'handle per la finestra padre.
[in] page
Valore che specifica la pagina nella finestra delle proprietà visualizzata. È indicizzato a zero.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
IPropertySheetProvider::Show( –1, 0) restituisceE_FAIL. Questo codice restituito può essere ignorato in questo caso.
In situazioni in cui lo snap-in crea una finestra delle proprietà in una chiamata a IPropertySheetProvider::CreatePropertySheet, facoltativamente chiama IPropertySheetProvider::AddPrimaryPages e IPropertySheetProvider::AddExtensionPages e quindi decide di non visualizzare la finestra delle proprietà, deve chiamare IPropertySheetProvider::Show( –1, 0) per eliminare la finestra delle proprietà e liberarne le risorse. In questo caso, lo snap-in deve eliminare gli handle della pagina delle proprietà creati. Questa operazione può essere eseguita prima o dopo che lo snap-in chiama IPropertySheetProvider::Show( -1, 0), perché MMC non usa gli handle della pagina delle proprietà.
IPropertySheetProvider::Show( –1, 0) elimina solo la finestra delle proprietà corrente, ovvero una creata, ma non ancora visualizzata. Dopo la visualizzazione di una finestra delle proprietà, lo snap-in non può chiuderlo a livello di codice. Solo l'utente può chiudere una finestra delle proprietà visualizzata. In questo caso, MMC elimina automaticamente tutte le pagine delle proprietà associate (strutture PROPSHEETPAGE ) fornite dallo snap-in.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| DLL | Mmcndmgr.dll |