setClusterServiceAccountPassword 函式 (clusapi.h)
[此函式可用於需求一節中指定的作業系統。 Windows Server 2008 已移除此函式的支援，此函式不會執行任何動作並傳回 ERROR_CALL_NOT_IMPLEMENTED。]
變更所有可用叢集節點上叢集服務使用者帳戶的密碼。 PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD類型會定義此函式的指標。
語法
DWORD SetClusterServiceAccountPassword(
[in] LPCWSTR lpszClusterName,
[in] LPCWSTR lpszNewPassword,
[in, optional] DWORD dwFlags,
[out] PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
[in, out] LPDWORD lpcbReturnStatusBufferSize
);
參數
[in] lpszClusterName
指定叢集名稱的 Null 終止 Unicode 字串。
[in] lpszNewPassword
Null終止的 Unicode 字串，指定叢集服務使用者帳戶的新密碼。
[in, optional] dwFlags
列舉自 CLUSTER_SET_PASSWORD_FLAGS 列舉的選擇性位欄位，其中包含描述如何將密碼更新套用至叢集的旗標。
根據預設， (dwFlags = 0) ，除非所有叢集節點都可用，否則函式將不會繼續。
CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1) )
即使所有節點都無法使用， 仍會導致 SetClusterServiceAccountPassword 函式繼續進行。 函式會嘗試變更任意數目節點上的密碼，但任何不在 ClusterNodeUp 或 ClusterNodePaused 狀態中的節點 (請參閱 GetClusterNodeState) 將不會更新。
[out] lpReturnStatusBuffer
輸出緩衝區的指標，該緩衝區會接收描述每個叢集節點密碼更新結果 的CLUSTER_SET_PASSWORD_STATUS 結構陣列。 如果此參數不是 Null ，而且緩衝區不夠大而無法保存產生的資料，則函式會傳回 ERROR_MORE_DATA ，並將 lcpuReturnStatusBufferSize 設定為輸出緩衝區所需的大小。 如果此參數為 Null，則不會執行任何密碼更新;函式會將 lcpuReturnStatusBufferSize 設定為所需的緩衝區大小，並傳回 ERROR_SUCCESS。
[in, out] lpcbReturnStatusBufferSize
在輸入時，指定輸出緩衝區) 位元組大小 (值的指標。 在輸出時，指向值，指定實際大小 (以位元組為單位) 產生的資料。 一律會指定輸出大小，即使 lpReturnStatusBuffer 為 Null 也 一樣。 此參數不可為 Null。
傳回值
如果作業成功，函式會 傳回 ERROR_SUCCESS (0) 。
如果作業失敗，函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。
| 傳回碼/值 | Description |
|---|---|
|
叢集中的某些節點 (無法使用，也就是不在 ClusterNodeStateUp 或 ClusterNodeStatePaused 狀態) ，且未設定 CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES 旗標。 |
|
lpReturnStatusBuffer指向的輸出緩衝區不夠大，無法保存產生的資料。 |
備註
根據預設，除非叢集中的所有節點都可用，否則 SetClusterServiceAccountPassword 函式不會執行任何動作， (也就是 ClusterNodeStateUp 或 ClusterNodeStatePaused 狀態) 。 您可以使用 CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES 旗標來覆寫此行為，但請注意，任何無法更新密碼的節點將無法加入叢集，直到該節點上手動更新密碼為止。
如果新密碼與節點上的舊密碼相同，則密碼更新不會套用至該節點，並傳回 ERROR_SUCCESS 。
此函式不會更新叢集服務使用者帳戶網域控制站所儲存的密碼。
請勿從資源 DLL 呼叫 SetClusterServiceAccountPassword 。
規格需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2003 Datacenter、Windows Server 2003 Enterprise |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |