Méthode IWEExtendWizard97::CreateWizard97Pages (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 de propriétés Wizard97 et de les ajouter à un Assistant Administrateur de cluster de basculement .

Syntaxe

HRESULT CreateWizard97Pages(
  [in] IUnknown            *piData,
  [in] IWCWizard97Callback *piCallback
);

Paramètres

[in] piData

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

Selon le type d’objet de cluster, 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 IWCWizard97Callback utilisée pour ajouter les nouvelles pages de propriétés Wizard97 à 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 de pages Wizard97.

Remarques

Remarques aux implémenteurs

Si votre extension n’a pas de pages Wizard97, mais n’a pas de pages Wizard97, vous pouvez :

Prend en charge uniquement l’interface IWEExtendWizard .
Prenez en charge les interfaces IWEExtendWizard et IWEExtendWizard97 , mais dans votre implémentation d’IWEExtendWizard97, interrogez l’interface IWCWizardCallback à partir de l’interface passée par le biais du paramètre piCallback .

Pour chaque page de propriétés Wizard97 à ajouter

Utilisez piData pour appeler QueryInterface et récupérer un pointeur d’interface pour l’objet 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 Wizard97 ne doit pas dépasser 293 unités de boîte de dialogue et 172 unités de dialogue de haut, et doit contenir un contrôle statique positionné sur (38,12) avec une taille de (247,10).
Pour ajouter la page à un Assistant Administrateur de cluster, appelez IWCWizard97Callback::AddWizard97Page à 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