SetClusterServiceAccountPassword-Funktion (clusapi.h)

Artikel
08/22/2023

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Die Unterstützung für diese Funktion wurde in Windows Server 2008 entfernt, und diese Funktion tut nichts und gibt ERROR_CALL_NOT_IMPLEMENTED zurück.]

Ändert das Kennwort für das Clusterdienstbenutzerkonto auf allen verfügbaren Clusterknoten. Der PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD SetClusterServiceAccountPassword(
  [in]           LPCWSTR                      lpszClusterName,
  [in]           LPCWSTR                      lpszNewPassword,
  [in, optional] DWORD                        dwFlags,
  [out]          PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
  [in, out]      LPDWORD                      lpcbReturnStatusBufferSize
);

Parameter

[in] lpszClusterName

Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Clusters angibt.

[in] lpszNewPassword

MIT NULL beendete Unicode-Zeichenfolge, die das neue Kennwort für das Benutzerkonto des Clusterdiensts angibt.

[in, optional] dwFlags

Optionales Bitfeld von Werten, die aus der CLUSTER_SET_PASSWORD_FLAGS Enumeration aufgelistet sind, die Flags enthalten, die beschreiben, wie die Kennwortaktualisierung auf den Cluster angewendet werden soll.

Standardmäßig (dwFlags = 0) wird die Funktion erst fortgesetzt, wenn alle Clusterknoten verfügbar sind.

CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))

Bewirkt, dass die SetClusterServiceAccountPassword-Funktion auch dann fortgesetzt wird, wenn nicht alle Knoten verfügbar sind. Die Funktion versucht, das Kennwort für so viele Knoten wie möglich zu ändern, aber alle Knoten, die sich nicht im Status ClusterNodeUp oder ClusterNodePaused befinden (siehe GetClusterNodeState), werden nicht aktualisiert.

[out] lpReturnStatusBuffer

Zeiger auf einen Ausgabepuffer, der ein Array von CLUSTER_SET_PASSWORD_STATUS Strukturen empfängt, die das Ergebnis der Kennwortaktualisierung für jeden Clusterknoten beschreiben. Wenn dieser Parameter nicht NULL ist und der Puffer nicht groß genug ist, um die resultierenden Daten aufzunehmen, gibt die Funktion ERROR_MORE_DATA zurück und legt lpcbReturnStatusBufferSize auf die erforderliche Größe für den Ausgabepuffer fest. Wenn dieser Parameter NULL ist, wird keine Kennwortaktualisierung durchgeführt. Die Funktion legt lpcbReturnStatusBufferSize auf die erforderliche Puffergröße fest und gibt ERROR_SUCCESS zurück.

[in, out] lpcbReturnStatusBufferSize

Zeigen Sie bei der Eingabe auf einen Wert, der die Größe (in Bytes) des Ausgabepuffers angibt. Zeigen Sie in der Ausgabe auf einen Wert, der die tatsächliche Größe (in Bytes) der resultierenden Daten angibt. Die Ausgabegröße wird immer angegeben, auch wenn lpReturnStatusBufferNULL ist. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS (0) zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden sind mögliche Fehlercodes aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_ALL_NODES_NOT_AVAILABLE 5037 (0x13AD)	Einige Knoten im Cluster sind nicht verfügbar (d. h. nicht im Status ClusterNodeStateUp oder ClusterNodeStatePaused ), und das flag CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES ist nicht festgelegt.
ERROR_MORE_DATA 234 (0xEA)	Der Ausgabepuffer, auf den lpReturnStatusBuffer verweist, war nicht groß genug, um die resultierenden Daten aufzunehmen.

Hinweise

Standardmäßig übernimmt die SetClusterServiceAccountPassword-Funktion nichts, es sei denn, alle Knoten im Cluster sind verfügbar (d. a. im Status ClusterNodeStateUp oder ClusterNodeStatePaused ). Sie können das CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES-Flag verwenden, um dieses Verhalten zu überschreiben, aber beachten Sie, dass jeder Knoten, der das Kennwort nicht aktualisieren kann, dem Cluster nicht beitreten kann, bis das Kennwort auf diesem Knoten manuell aktualisiert wird.

Wenn das neue Kennwort mit dem alten Kennwort auf einem Knoten identisch ist, wird die Kennwortaktualisierung nicht auf diesen Knoten angewendet, und ERROR_SUCCESS wird zurückgegeben.

Diese Funktion aktualisiert nicht das Kennwort, das von den Domänencontrollern für das Benutzerkonto des Clusterdiensts gespeichert ist.

Rufen Sie SetClusterServiceAccountPassword nicht über eine Ressourcen-DLL auf.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 Datacenter, Windows Server 2003 Enterprise
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

CLUSTER_SET_PASSWORD_FLAGS

CLUSTER_SET_PASSWORD_STATUS

Clusterverwaltungsfunktionen

Freigeben über