Fonction SetClusterServiceAccountPassword (clusapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette fonction a été supprimée dans Windows Server 2008 et cette fonction ne fait rien et retourne ERROR_CALL_NOT_IMPLEMENTED.]
Modifie le mot de passe du compte d’utilisateur du service de cluster sur tous les nœuds de cluster disponibles. Le type PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD définit un pointeur vers cette fonction.
Syntaxe
DWORD SetClusterServiceAccountPassword(
[in] LPCWSTR lpszClusterName,
[in] LPCWSTR lpszNewPassword,
[in, optional] DWORD dwFlags,
[out] PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
[in, out] LPDWORD lpcbReturnStatusBufferSize
);
Paramètres
[in] lpszClusterName
Chaîne Unicode terminée par null spécifiant le nom du cluster.
[in] lpszNewPassword
Chaîne Unicode terminée par null spécifiant le nouveau mot de passe pour le compte d’utilisateur du service de cluster.
[in, optional] dwFlags
Champ de bits facultatif de valeurs énumérées à partir de l’énumération CLUSTER_SET_PASSWORD_FLAGS contenant des indicateurs qui décrivent la façon dont la mise à jour du mot de passe doit être appliquée au cluster.
Par défaut (dwFlags = 0), la fonction ne se poursuit que si tous les nœuds de cluster sont disponibles.
CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))
Entraîne la poursuite de la fonction SetClusterServiceAccountPassword , même si tous les nœuds ne sont pas disponibles. La fonction tente de modifier le mot de passe sur autant de nœuds qu’elle le peut, mais tous les nœuds qui ne se trouvent pas dans les états ClusterNodeUp ou ClusterNodePaused (voir GetClusterNodeState) ne seront pas mis à jour.
[out] lpReturnStatusBuffer
Pointeur vers une mémoire tampon de sortie qui reçoit un tableau de structures CLUSTER_SET_PASSWORD_STATUS décrivant le résultat de la mise à jour du mot de passe pour chaque nœud de cluster. Si ce paramètre n’est pas NULL et que la mémoire tampon n’est pas assez grande pour contenir les données obtenues , la fonction retourne ERROR_MORE_DATA et définit lpcbReturnStatusBufferSize à la taille requise pour la mémoire tampon de sortie. Si ce paramètre a la valeur NULL, aucune mise à jour de mot de passe n’est effectuée ; la fonction définit lpcbReturnStatusBufferSize sur la taille de mémoire tampon requise et retourne ERROR_SUCCESS.
[in, out] lpcbReturnStatusBufferSize
En entrée, pointeur vers une valeur spécifiant la taille (en octets) de la mémoire tampon de sortie. Lors de la sortie, pointez vers une valeur spécifiant la taille réelle (en octets) des données obtenues. La taille de sortie est toujours spécifiée, même si lpReturnStatusBuffer a la valeur NULL. Ce paramètre ne peut pas avoir la valeur NULL.
Valeur retournée
Si l’opération réussit, la fonction retourne ERROR_SUCCESS (0).
Si l’opération échoue, la fonction retourne un code d’erreur système. Voici les codes d’erreur possibles.
| Code/valeur de retour | Description |
|---|---|
|
Certains nœuds du cluster ne sont pas disponibles (autrement dit, pas dans les états ClusterNodeStateUp ou ClusterNodeStatePaused ) et l’indicateur CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES n’est pas défini. |
|
La mémoire tampon de sortie pointée par lpReturnStatusBuffer n’était pas assez grande pour contenir les données obtenues. |
Remarques
Par défaut, la fonction SetClusterServiceAccountPassword ne fait rien, sauf si tous les nœuds du cluster sont disponibles (autrement dit, dans les états ClusterNodeStateUp ou ClusterNodeStatePaused ). Vous pouvez utiliser l’indicateur CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES pour remplacer ce comportement, mais notez que tout nœud qui ne parvient pas à mettre à jour le mot de passe ne pourra pas rejoindre le cluster tant que le mot de passe n’est pas mis à jour manuellement sur ce nœud.
Si le nouveau mot de passe est identique à l’ancien mot de passe sur un nœud, la mise à jour du mot de passe n’est pas appliquée à ce nœud et ERROR_SUCCESS est retourné.
Cette fonction ne met pas à jour le mot de passe stocké par les contrôleurs de domaine pour le compte d’utilisateur du service de cluster.
N’appelez pas SetClusterServiceAccountPassword à partir d’une DLL de ressource.
Configuration requise
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 Datacenter, Windows Server 2003 Entreprise |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |