Funzione SetClusterServiceAccountPassword (clusapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Il supporto per questa funzione è stato rimosso in Windows Server 2008 e questa funzione non esegue alcuna operazione e restituisce ERROR_CALL_NOT_IMPLEMENTED.]
Modifica la password per l'account utente del servizio cluster in tutti i nodi del cluster disponibili. Il tipo PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD definisce un puntatore a questa funzione.
Sintassi
DWORD SetClusterServiceAccountPassword(
[in] LPCWSTR lpszClusterName,
[in] LPCWSTR lpszNewPassword,
[in, optional] DWORD dwFlags,
[out] PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
[in, out] LPDWORD lpcbReturnStatusBufferSize
);
Parametri
[in] lpszClusterName
Stringa Unicode con terminazione NULL che specifica il nome del cluster.
[in] lpszNewPassword
Stringa Unicode con terminazione NULL che specifica la nuova password per l'account utente del servizio cluster.
[in, optional] dwFlags
Campo di bit facoltativo dei valori enumerati dall'enumerazione CLUSTER_SET_PASSWORD_FLAGS contenente flag che descrivono come applicare l'aggiornamento della password al cluster.
Per impostazione predefinita (dwFlags = 0), la funzione non procederà a meno che non siano disponibili tutti i nodi del cluster.
CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))
Fa sì che la funzione SetClusterServiceAccountPassword proceda anche se tutti i nodi non sono disponibili. La funzione tenterà di modificare la password in tutti i nodi possibili, ma tutti i nodi che non si trovano negli stati ClusterNodeUp o ClusterNodePaused (vedere GetClusterNodeState) non verranno aggiornati.
[out] lpReturnStatusBuffer
Puntatore a un buffer di output che riceve una matrice di strutture CLUSTER_SET_PASSWORD_STATUS che descrivono il risultato dell'aggiornamento della password per ogni nodo del cluster. Se questo parametro non è NULL e il buffer non è sufficientemente grande da contenere i dati risultanti, la funzione restituisce ERROR_MORE_DATA e imposta lpcbReturnStatusBufferSize sulle dimensioni necessarie per il buffer di output. Se questo parametro è NULL, non verrà eseguito alcun aggiornamento della password; la funzione imposterà lpcbReturnStatusBufferSize sulle dimensioni del buffer necessarie e restituirà ERROR_SUCCESS.
[in, out] lpcbReturnStatusBufferSize
In input, puntatore a un valore che specifica le dimensioni (in byte) del buffer di output. Nell'output, puntatore a un valore che specifica le dimensioni effettive (in byte) dei dati risultanti. Le dimensioni di output vengono sempre specificate, anche se lpReturnStatusBuffer è NULL. Questo parametro non può essere NULL.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS (0).
Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema. Di seguito sono riportati i possibili codici di errore.
| Codice/valore restituito | Descrizione |
|---|---|
|
Alcuni nodi del cluster non sono disponibili( ovvero non negli stati ClusterNodeStateUp o ClusterNodeStatePaused ) e il flag CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES non è impostato. |
|
Il buffer di output a cui punta lpReturnStatusBuffer non è sufficiente per contenere i dati risultanti. |
Commenti
Per impostazione predefinita, la funzione SetClusterServiceAccountPassword non esegue alcuna operazione a meno che non siano disponibili tutti i nodi del cluster, ovvero negli stati ClusterNodeStateUp o ClusterNodeStatePaused . È possibile usare il flag CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES per eseguire l'override di questo comportamento, ma si noti che qualsiasi nodo che non riesce ad aggiornare la password non sarà in grado di aggiungere il cluster fino a quando la password non viene aggiornata manualmente in tale nodo.
Se la nuova password corrisponde alla vecchia password in un nodo, l'aggiornamento della password non viene applicato a tale nodo e viene restituito ERROR_SUCCESS .
Questa funzione non aggiorna la password archiviata dai controller di dominio per l'account utente del servizio cluster.
Non chiamare SetClusterServiceAccountPassword da una DLL della risorsa.
Requisiti
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2003 Datacenter, Windows Server 2003 Enterprise |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |