OpenClusterNodeEx 함수(clusapi.h)
노드를 열고 노드에 대한 핸들을 반환합니다.
구문
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
매개 변수
[in] hCluster
OpenCluster 또는 OpenClusterEx 함수에서 반환 된 클러스터에 대한 핸들입니다.
[in, optional] lpszNodeName
기존 노드의 NetBIOS 이름에 대한 포인터입니다. 노드의 DNS 이름을 사용하면 OpenClusterNodeEx 함수가 실패하고 GetLastError 가 ERROR_CLUSTER_NODE_NOT_FOUND 반환합니다.
[in] dwDesiredAccess
요청된 액세스 권한입니다. GENERIC_READ(0x80000000), GENERIC_ALL(0x10000000) 또는 MAXIMUM_ALLOWED(0x02000000)의 조합일 수 있습니다. 이 값이 0이고 정의되지 않은 오류가 반환될 수 있습니다. GENERIC_ALL 사용하는 것은 OpenClusterNode를 호출하는 것과 같습니다.
[out, optional] lpdwGrantedAccess
부여된 액세스 권한을 받을 DWORD 의 주소를 포함하는 선택적 매개 변수입니다. DesiredAccess 매개 변수가 MAXIMUM_ALLOWED(0x02000000)이면 이 매개 변수가 가리키는 DWORD에 이 사용자에게 부여된 최대 권한이 포함됩니다.
반환 값
작업이 성공하면 OpenClusterNodeEx 는 노드 핸들을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 대상 서버가 OpenClusterNodeEx 함수를 지원하지 않는 경우(예: 대상 서버가 Windows Server 2008 이하를 실행하는 경우) GetLastError 함수는 RPC_S_PROCNUM_OUT_OF_RANGE (1745)를 반환합니다. |
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |