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

Weitere Informationen

Name