Méthode IPropertySheetCallback ::AddPage (mmc.h)
La méthode IPropertySheetCallback ::AddPage permet à un composant logiciel enfichable d’ajouter une page à une feuille de propriétés.
Syntaxe
HRESULT AddPage(
[in] HPROPSHEETPAGE hPage
);
Paramètres
[in] hPage
Valeur qui spécifie le handle à la page à ajouter. Le paramètre hPage est un handle pour une structure PROPSHEETPAGE créée par l’API Windows CreatePropertySheetPage.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Remarques
Le composant logiciel enfichable ne peut pas appeler AddPage à partir d’un gestionnaire de page de propriétés, car la page de propriétés est créée et s’exécute sur un thread secondaire. Un composant logiciel enfichable ne peut pas appeler une interface MMC à partir d’un thread différent de celui dans lequel le composant logiciel enfichable a été créé. L’emplacement approprié pour appeler AddPage se trouve dans l’implémentation du composant logiciel enfichable de la méthode IExtendPropertySheet2 ::CreatePropertyPages .
Si un composant logiciel enfichable utilise directement l’interface IPropertySheetProvider, il peut utiliser AddPage pour ajouter les pages principales, puis appeler IPropertySheetProvider ::AddPrimaryPages (NULL, FALSE, NULL, [TRUE ou FALSE]) afin que le fournisseur ajoute ces pages à la feuille de propriétés. Pour plus d’informations sur la création de vos pages de propriétés dans l’implémentation du composant logiciel enfichable de IExtendPropertySheet2 ::CreatePropertyPages, consultez IPropertySheetProvider ::AddPrimaryPages.
Les pages sont ajoutées à la feuille dans l’ordre dans lequel elles sont présentées. Les pages du composant logiciel enfichable principal sont toujours ajoutées en premier.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| DLL | Mmcndmgr.dll |