Méthode IWEExtendWizard::CreateWizardPages (cluadmex.h)

Article
08/22/2023

[Cette méthode peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette méthode a été supprimée dans Windows Server 2008.]

Vous permet de créer des pages d’Assistant et de les ajouter à l’Assistant Nouvelle ressource de l’administrateur du cluster de basculement ou à l’Assistant Application de cluster.

Syntaxe

HRESULT CreateWizardPages(
  [in] IUnknown          *piData,
  [in] IWCWizardCallback *piCallback
);

Paramètres

[in] piData

Pointeur d’interface IUnknown pour récupérer les informations relatives aux pages de l’Assistant à ajouter. En appelant IUnknown::QueryInterface avec le pointeur piData , les interfaces suivantes sont disponibles :

Selon le type d’objet de cluster pour lequel la page de l’Assistant est en cours de création, 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 IWCWizardCallback utilisée pour ajouter les nouvelles pages de propriétés à l’Assistant.

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 d’une page de propriétés à l’Assistant Création de groupe ou à l’Assistant Création de ressources.

Notes

Pour ajouter des pages de l’Assistant Wizard97, utilisez la méthode IWEExtendWizard97::CreateWizard97Pages .

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 nouvelle 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 en cours d’extension, 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 (247,10).
Pour ajouter la page à un Assistant Administrateur de cluster, appelez IWCWizardCallback::AddWizardPage à l’aide du pointeur piCallback .

Configuration requise


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