Méthode IExtendPropertySheet::CreatePropertyPages (mmc.h)

Article
08/24/2023

Ajoute des pages à une feuille de propriétés.

Syntaxe

HRESULT CreatePropertyPages(
  [in] LPPROPERTYSHEETCALLBACK lpProvider,
  [in] LONG_PTR                handle,
  [in] LPDATAOBJECT            lpIDataObject
);

Paramètres

[in] lpProvider

Pointeur vers l’interface IPropertySheetCallback .

[in] handle

Valeur qui spécifie le handle utilisé pour acheminer le message de notification MMCN_PROPERTY_CHANGE vers l’interface IComponent ou IComponentData appropriée.

Pour les composants logiciels enfichables qui utilisent directement l’interface IPropertySheetProvider , MMC crée le handle lorsque le composant logiciel enfichable appelle IPropertySheetProvider::AddPrimaryPages et spécifie sa valeur bCreateHandle sur TRUE.

[in] lpIDataObject

Pointeur vers l’interface IDataObject sur l’objet qui contient des informations de contexte sur l’étendue ou l’élément de résultat.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

L’interface IPropertySheetCallback est passée au composant logiciel enfichable lors d’un appel à cette méthode. La durée de vie de cette interface est sous le contrôle de MMC. Par conséquent, le pointeur lpIDataObject est valide uniquement pendant la durée de vie de l’appel immédiat à cette méthode. Il n’est pas recommandé de mettre en cache la valeur du pointeur lpIDataObject en dehors du rappel.

Le handle spécifié par le paramètre handle doit être enregistré dans l’objet page de propriétés pour notifier le parent des modifications de propriété à l’aide de la fonction API MMCPropertyChangeNotify.

Si le composant logiciel enfichable retourne un code de réussite (S_OK, S_FALSE) à partir de CreatePropertyPages, le composant logiciel enfichable doit appeler MMCFreeNotifyHandle. Si le composant logiciel enfichable retourne un code d’erreur, MMC libère immédiatement le handle. Pour plus d’informations sur le moment où MMCFreeNotifyHandle doit être appelé, consultez MMCFreeNotifyHandle.