Función SetClusterServiceAccountPassword (clusapi.h)
[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. La compatibilidad con esta función se quitó en Windows Server 2008 y esta función no hace nada y devuelve ERROR_CALL_NOT_IMPLEMENTED.]
Cambia la contraseña de la cuenta de usuario del servicio de clúster en todos los nodos de clúster disponibles. El tipo PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD define un puntero a esta función.
Sintaxis
DWORD SetClusterServiceAccountPassword(
[in] LPCWSTR lpszClusterName,
[in] LPCWSTR lpszNewPassword,
[in, optional] DWORD dwFlags,
[out] PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
[in, out] LPDWORD lpcbReturnStatusBufferSize
);
Parámetros
[in] lpszClusterName
Cadena Unicode terminada en NULL que especifica el nombre del clúster.
[in] lpszNewPassword
Cadena Unicode terminada en NULL que especifica la nueva contraseña para la cuenta de usuario del servicio de clúster.
[in, optional] dwFlags
Campo de bits opcional de valores enumerados en la enumeración CLUSTER_SET_PASSWORD_FLAGS que contiene marcas que describen cómo se va a aplicar la actualización de contraseña al clúster.
De forma predeterminada (dwFlags = 0), la función no continuará a menos que todos los nodos del clúster estén disponibles.
CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))
Hace que la función SetClusterServiceAccountPassword continúe incluso si todos los nodos no están disponibles. La función intentará cambiar la contraseña en tantos nodos como pueda, pero no se actualizarán los nodos que no estén en los estados ClusterNodeUp o ClusterNodePaused (consulte GetClusterNodeState).
[out] lpReturnStatusBuffer
Puntero a un búfer de salida que recibe una matriz de estructuras de CLUSTER_SET_PASSWORD_STATUS que describen el resultado de la actualización de contraseña para cada nodo de clúster. Si este parámetro no es NULL y el búfer no es lo suficientemente grande como para contener los datos resultantes, la función devuelve ERROR_MORE_DATA y establece lpcbReturnStatusBufferSize en el tamaño necesario para el búfer de salida. Si este parámetro es NULL, no se realizará ninguna actualización de contraseña; La función establecerá lpcbReturnStatusBufferSize en el tamaño de búfer necesario y devolverá ERROR_SUCCESS.
[in, out] lpcbReturnStatusBufferSize
En la entrada, puntero a un valor que especifica el tamaño (en bytes) del búfer de salida. En la salida, puntero a un valor que especifica el tamaño real (en bytes) de los datos resultantes. El tamaño de salida siempre se especifica, incluso si lpReturnStatusBuffer es NULL. Este parámetro no puede ser NULL.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS (0).
Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestran códigos de error posibles.
| Código o valor devuelto | Descripción |
|---|---|
|
Algunos nodos del clúster no están disponibles (es decir, no en los estados ClusterNodeStateUp o ClusterNodeStatePaused ) y no se establece la marca CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES . |
|
El búfer de salida al que apunta lpReturnStatusBuffer no era lo suficientemente grande como para contener los datos resultantes. |
Comentarios
De forma predeterminada, la función SetClusterServiceAccountPassword no hace nada a menos que todos los nodos del clúster estén disponibles (es decir, en los estados ClusterNodeStateUp o ClusterNodeStatePaused ). Puede usar la marca CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES para invalidar este comportamiento, pero tenga en cuenta que cualquier nodo que no pueda actualizar la contraseña no podrá unirse al clúster hasta que la contraseña se actualice manualmente en ese nodo.
Si la nueva contraseña es la misma que la antigua en un nodo, la actualización de contraseña no se aplica a ese nodo y se devuelve ERROR_SUCCESS .
Esta función no actualiza la contraseña almacenada por los controladores de dominio para la cuenta de usuario del servicio de clúster.
No llame a SetClusterServiceAccountPassword desde un archivo DLL de recursos.
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 Datacenter, Windows Server 2003 Enterprise |
| Plataforma de destino | Windows |
| Encabezado | clusapi.h |
| Library | ClusAPI.lib |
| Archivo DLL | ClusAPI.dll |