SetClusterName-Funktion (clusapi.h)
Legt den Namen für einen Cluster fest. Der PCLUSAPI_SetClusterName Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD SetClusterName(
[in] HCLUSTER hCluster,
[in] LPCWSTR lpszNewClusterName
);
Parameter
[in] hCluster
Handle für einen umzubenennten Cluster.
[in] lpszNewClusterName
Zeiger auf eine Unicode-Zeichenfolge mit Null-Termin, die den neuen Clusternamen enthält.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_RESOURCE_PROPERTIES_STORED zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.
Hinweise
Der Clustername wird in der privaten Name-Eigenschaft der Netzwerknamen-Kernressource (d. a. der Netzwerkname-Ressource des Clusters) gespeichert. Aufgrund möglicher Abhängigkeiten von dieser Ressource ist die Änderung erst wirksam, wenn die Netzwerknamenressource wieder online geschaltet wird.
Rufen Sie SetClusterName nicht aus einer Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.
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 | clusapi.h |
| Bibliothek | ClusAPI.lib |
| DLL | ClusAPI.dll |