Função SetClusterServiceAccountPassword (clusapi.h)
[Essa função está disponível para uso nos sistemas operacionais especificados na seção Requisitos. O suporte para essa função foi removido no Windows Server 2008 e essa função não faz nada e retorna ERROR_CALL_NOT_IMPLEMENTED.]
Altera a senha da conta de usuário do serviço de cluster em todos os nós de cluster disponíveis. O tipo PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD define um ponteiro para essa função.
Sintaxe
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
Cadeia de caracteres Unicode terminada em NULL especificando o nome do cluster.
[in] lpszNewPassword
Cadeia de caracteres Unicode terminada em NULL especificando a nova senha para a conta de usuário do serviço de cluster.
[in, optional] dwFlags
Campo de bits opcional de valores enumerados da enumeração CLUSTER_SET_PASSWORD_FLAGS que contém sinalizadores que descrevem como a atualização de senha deve ser aplicada ao cluster.
Por padrão (dwFlags = 0), a função não continuará, a menos que todos os nós de cluster estejam disponíveis.
CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))
Faz com que a função SetClusterServiceAccountPassword continue mesmo se todos os nós não estiverem disponíveis. A função tentará alterar a senha no máximo de nós possível, mas os nós que não estiverem nos estados ClusterNodeUp ou ClusterNodePaused (consulte GetClusterNodeState) não serão atualizados.
[out] lpReturnStatusBuffer
Ponteiro para um buffer de saída que recebe uma matriz de estruturas CLUSTER_SET_PASSWORD_STATUS que descrevem o resultado da atualização de senha para cada nó de cluster. Se esse parâmetro não for NULL e o buffer não for grande o suficiente para manter os dados resultantes, a função retornará ERROR_MORE_DATA e definirá lpcbReturnStatusBufferSize como o tamanho necessário para o buffer de saída. Se esse parâmetro for NULL, nenhuma atualização de senha será executada; a função definirá lpcbReturnStatusBufferSize para o tamanho do buffer necessário e retornará ERROR_SUCCESS.
[in, out] lpcbReturnStatusBufferSize
Na entrada, ponteiro para um valor que especifica o tamanho (em bytes) do buffer de saída. Na saída, ponteiro para um valor que especifica o tamanho real (em bytes) dos dados resultantes. O tamanho da saída é sempre especificado, mesmo que lpReturnStatusBuffer seja NULL. Esse parâmetro não pode ser NULL.
Valor retornado
Se a operação for bem-sucedida, a função retornará ERROR_SUCCESS (0).
Se a operação falhar, a função retornará um código de erro do sistema. Veja a seguir possíveis códigos de erro.
| Valor/código retornado | Descrição |
|---|---|
|
Alguns nós no cluster não estão disponíveis (ou seja, não nos estados ClusterNodeStateUp ou ClusterNodeStatePaused ) e o sinalizador CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES não está definido. |
|
O buffer de saída apontado por lpReturnStatusBuffer não era grande o suficiente para manter os dados resultantes. |
Comentários
Por padrão, a função SetClusterServiceAccountPassword não faz nada, a menos que todos os nós no cluster estejam disponíveis (ou seja, nos estados ClusterNodeStateUp ou ClusterNodeStatePaused ). Você pode usar o sinalizador CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES para substituir esse comportamento, mas observe que qualquer nó que não atualizar a senha não poderá ingressar no cluster até que a senha seja atualizada manualmente nesse nó.
Se a nova senha for a mesma que a senha antiga em um nó, a atualização de senha não será aplicada a esse nó e ERROR_SUCCESS será retornado.
Essa função não atualiza a senha armazenada pelos controladores de domínio para a conta de usuário do serviço de cluster.
Não chame SetClusterServiceAccountPassword de uma DLL de recurso.
Requisitos
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2003 Datacenter, Windows Server 2003 Enterprise |
| Plataforma de Destino | Windows |
| Cabeçalho | clusapi.h |
| Biblioteca | ClusAPI.lib |
| DLL | ClusAPI.dll |