IWEExtendPropertySheet ::CreatePropertySheetPages, méthode (cluadmex.h)

Article
08/22/2023

Crée des pages de propriétés pour un objet de cluster et les ajoute à une feuille de propriétés Administrateur du cluster de basculement .

Syntaxe

HRESULT CreatePropertySheetPages(
  [in] IUnknown                 *piData,
  [in] IWCPropertySheetCallback *piCallback
);

Paramètres

[in] piData

Pointeur d’interface IUnknown pour récupérer des informations relatives aux nouvelles pages de propriétés. En appelant la méthode IUnknown ::QueryInterface avec le pointeur piData , les interfaces suivantes sont disponibles :

Selon le type d’objet de cluster pour lequel les pages de feuille de propriétés sont créées, un pointeur vers l’une des interfaces suivantes est également disponible :

IGetClusterNodeInfo, si la page de propriétés est liée à un nœud.
IGetClusterGroupInfo, si la page de propriétés est liée à un groupe.
IGetClusterNetworkInfo, si la page de propriétés est liée à un réseau.
IGetClusterNetInterfaceInfo, si la page de propriétés est liée à une interface réseau.
IGetClusterResourceInfo, si la page de propriétés est liée à une ressource.

[in] piCallback

Pointeur vers une implémentation d’interface IWCPropertySheetCallback pour ajouter des pages de propriétés à la feuille des propriétés Administrateur de cluster.

Valeur retournée

Retourne l’une des valeurs suivantes ou toute valeur HRESULT qui décrit les résultats de l’opération.

Code/valeur de retour	Description
NOERROR 0	L'opération a réussi.
E_INVALIDARG 0x80070057	Au moins l’un des paramètres n’est pas valide.
E_NOTIMPL 0x80004001	L’extension ne prend pas en charge l’ajout de pages de propriétés.

Remarques

L’administrateur du cluster de basculement appelle la méthode CreatePropertySheetPages d’une extension pour étendre une feuille de propriétés afin de gérer un objet de cluster supplémentaire.

Remarques aux implémenteurs

Pour chaque page de propriétés à ajouter

Utilisez piData pour appeler QueryInterface et récupérer un pointeur d’interface pour l’objet de cluster associé à la page. Par exemple, si vous ajoutez une page de propriétés pour une ressource, vous souhaitez récupérer un pointeur vers l’interface IGetClusterResourceInfo . Bien qu’il soit possible d’interroger correctement les interfaces qui récupèrent des données non liées à l’objet cible, vous devez vous attendre à recevoir des erreurs lorsque vous tentez d’appeler les méthodes.
Pour créer la page, appelez la fonction CreatePropertySheetPage. Pour produire des pages qui ressemblent aux pages fournies par l’administrateur de cluster, chaque nouvelle page de propriétés ne doit pas dépasser 252 unités de dialogue et 218 unités de dialogue de haut, et doit contenir deux contrôles standard :
- Pour l’icône d’objet, un contrôle d’icône positionné sur (8,7) avec une taille de (18,20).
- Pour le nom de l’objet, contrôle statique positionné sur (38,12) avec une taille de (206,10).
Pour ajouter la page à la feuille de propriétés, appelez la méthode IWCPropertySheetCallback ::AddPropertySheetPage pointée par piCallback.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	cluadmex.h