IWEExtendPropertySheet::CreatePropertySheetPages-Methode (cluadmex.h)
Erstellt Eigenschaftenseiten für ein Clusterobjekt und fügt sie einem Eigenschaftenblatt des Failoverclusteradministrators hinzu.
Syntax
HRESULT CreatePropertySheetPages(
[in] IUnknown *piData,
[in] IWCPropertySheetCallback *piCallback
);
Parameter
[in] piData
IUnknown-Schnittstellenzeiger zum Abrufen von Informationen zu den neuen Eigenschaftenseiten. Durch Aufrufen der IUnknown::QueryInterface-Methode mit dem piData-Zeiger stehen die folgenden Schnittstellen zur Verfügung:
Abhängig vom Typ des Clusterobjekts , für das Eigenschaftenblattseiten erstellt werden, 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 IWCPropertySheetCallback-Schnittstellenimplementierung zum Hinzufügen von Eigenschaftenseiten zum Eigenschaftenblatt des Clusteradministrators.
Rückgabewert
Gibt einen der folgenden Werte oder ein beliebiges HRESULT zurück, das die Ergebnisse des Vorgangs beschreibt.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Mindestens einer der Parameter ist ungültig. |
|
Das Hinzufügen von Eigenschaftenseiten wird von der Erweiterung nicht unterstützt. |
Hinweise
Der Failoverclusteradministrator ruft die CreatePropertySheetPages-Methode einer Erweiterung auf, um ein Eigenschaftenblatt zu erweitern, um ein zusätzliches Clusterobjekt zu verarbeiten.
Hinweise für Implementierer
Für jede hinzuzufügende Eigenschaftenseite
- Verwenden Sie piData , um QueryInterface aufzurufen und einen Schnittstellenzeiger für das der Seite zugeordnete Clusterobjekt abzurufen. 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 nicht mit dem Zielobjekt verbunden sind, sollten Sie mit Fehlern rechnen, wenn Sie versuchen, die Methoden aufzurufen.
-
Rufen Sie zum Erstellen der Seite 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 (206,10) positioniert ist.
- Um die Seite dem Eigenschaftenblatt hinzuzufügen, rufen Sie die IWCPropertySheetCallback::AddPropertySheetPage-Methode auf, auf die piCallback verweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | cluadmex.h |