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로 끝나는 유니코드 문자열입니다.
[in] lpszNewPassword
클러스터 서비스 사용자 계정에 대한 새 암호를 지정하는 NULL 종료 유니코드 문자열입니다.
[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 반환하고 lpcbReturnStatusBufferSize 를 출력 버퍼에 필요한 크기로 설정합니다. 이 매개 변수가 NULL이면 암호 업데이트가 수행되지 않습니다. 함수는 lpcbReturnStatusBufferSize 를 필요한 버퍼 크기로 설정하고 ERROR_SUCCESS 반환합니다.
[in, out] lpcbReturnStatusBufferSize
입력에서 출력 버퍼의 크기(바이트)를 지정하는 값에 대한 포인터입니다. 출력에서 결과 데이터의 실제 크기(바이트)를 지정하는 값에 대한 포인터입니다. lpReturnStatusBuffer가 NULL인 경우에도 출력 크기는 항상 지정됩니다. 이 매개 변수는 NULL일 수 없습니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS (0)을 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
클러스터의 일부 노드(즉, 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 |