SetClusterServiceAccountPassword-Funktion (clusapi.h)
[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 |
|---|---|
|
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. |
|
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 |