Metodo IPropertySheetCallback::AddPage (mmc.h)
Il metodo IPropertySheetCallback::AddPage consente a uno snap-in di aggiungere una pagina a un foglio delle proprietà.
Sintassi
HRESULT AddPage(
[in] HPROPSHEETPAGE hPage
);
Parametri
[in] hPage
Valore che specifica l'handle nella pagina da aggiungere. Il parametro hPage è un handle per una struttura PROPSHEETPAGE creata dall'API Windows CreatePropertySheetPage.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
Lo snap-in non può chiamare AddPage dall'interno di un gestore di pagine delle proprietà perché la pagina delle proprietà viene creata ed eseguita in un thread secondario. Uno snap-in non può chiamare un'interfaccia MMC da un thread diverso rispetto a quello in cui è stato creato lo snap-in. La posizione corretta per chiamare AddPage è nell'implementazione dello snap-in del metodo IExtendPropertySheet2::CreatePropertyPages .
Se uno snap-in usa direttamente l'interfaccia IPropertySheetProvider, può usare AddPage per aggiungere le pagine primarie e quindi chiamare IPropertySheetProvider::AddPrimaryPages (NULL, FALSE, NULL, [TRUE o FALSE]) in modo che il provider aggiungerà queste pagine al foglio delle proprietà. Per altre informazioni su come creare le pagine delle proprietà nell'implementazione dello snap-in di IExtendPropertySheet2::CreatePropertyPages, vedere IPropertySheetProvider::AddPrimaryPages.
Le pagine vengono aggiunte al foglio nell'ordine in cui vengono presentate. Le pagine dello snap-in primario vengono sempre aggiunte prima.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| DLL | Mmcndmgr.dll |