IWEExtendWizard::CreateWizardPages-Methode (cluadmex.h)
[Diese Methode steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]
Ermöglicht das Erstellen von Assistentenseiten und das Hinzufügen dieser Seiten zum Assistenten für neue Ressourcen des Failoverclusteradministrators oder zum Clusteranwendungs-Assistenten.
Syntax
HRESULT CreateWizardPages(
[in] IUnknown *piData,
[in] IWCWizardCallback *piCallback
);
Parameter
[in] piData
IUnknown-Schnittstellenzeiger zum Abrufen von Informationen im Zusammenhang mit den hinzuzufügenden Assistentenseiten. Durch Aufrufen von IUnknown::QueryInterface mit dem piData-Zeiger sind die folgenden Schnittstellen verfügbar:
Abhängig vom Typ des Clusterobjekts , für das die Assistentenseite erstellt wird, ist auch ein Zeiger auf eine der folgenden Schnittstellen verfügbar:- IGetClusterNodeInfo, wenn sich die Eigenschaftenseite auf einen Knoten bezieht.
- IGetClusterGroupInfo, wenn sich die Eigenschaftenseite auf eine Gruppe bezieht.
- IGetClusterNetworkInfo, wenn sich die Eigenschaftenseite auf ein Netzwerk bezieht.
- IGetClusterNetInterfaceInfo, wenn sich die Eigenschaftenseite auf eine Netzwerkschnittstelle bezieht.
- IGetClusterResourceInfo, wenn sich die Eigenschaftenseite auf eine Ressource bezieht.
[in] piCallback
Zeiger auf eine IWCWizardCallback-Schnittstellenimplementierung , die zum Hinzufügen der neuen Eigenschaftenseiten zum Assistenten verwendet wird.
Rückgabewert
Gibt einen der folgenden Werte oder einen beliebigen HRESULT-Wert zurück, der die Ergebnisse des Vorgangs beschreibt.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Mindestens einer der Parameter ist ungültig. |
|
Die Erweiterung unterstützt das Hinzufügen einer Eigenschaftenseite zum Assistenten zum Erstellen einer Gruppe oder zum Ressourcenerstellungs-Assistenten nicht. |
Hinweise
Um Wizard97-Assistentenseiten hinzuzufügen, verwenden Sie die IWEExtendWizard97::CreateWizard97Pages-Methode .
Hinweise zu Implementierern
Für jede hinzuzufügende Eigenschaftenseite
- Verwenden Sie piData , um QueryInterface aufzurufen und einen Schnittstellenzeiger für das Clusterobjekt abzurufen, das der neuen Seite zugeordnet ist. Wenn Sie beispielsweise eine Eigenschaftenseite für eine Ressource hinzufügen, möchten Sie einen Zeiger auf die IGetClusterResourceInfo-Schnittstelle abrufen. Obwohl es möglich ist, Schnittstellen erfolgreich abzufragen, die Daten abrufen, die nichts mit dem objektbezogenen Objekt zu tun haben, sollten Sie beim Versuch, die Methoden aufzurufen, Fehler erhalten.
-
Um die Seite zu erstellen, rufen Sie die Funktion CreatePropertySheetPage auf. Um Seiten zu erstellen, die den vom Clusteradministrator bereitgestellten Seiten ähneln, sollte jede neue Eigenschaftenseite nicht größer als 252 Dialogeinheiten breit und 218 Dialogeinheiten hoch sein und zwei Standardsteuerelemente enthalten:
- Für das Objektsymbol ein Symbolsteuerelement, das bei (8,7) mit einer Größe von (18,20) positioniert ist.
- Für den Objektnamen ein statisches Steuerelement, das bei (38,12) mit einer Größe von (247,10) positioniert ist.
- Um die Seite einem Clusteradministrator-Assistenten hinzuzufügen, rufen Sie IWCWizardCallback::AddWizardPage mithilfe des piCallback-Zeigers auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 Enterprise, Windows Server 2003 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | cluadmex.h |