OpenClusterEx 함수(clusapi.h)

클러스터에 대한 연결을 열고 클러스터에 대한 핸들을 반환합니다.

구문

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

매개 변수

[in, optional] lpszClusterName

다음 값 중 하나를 지정합니다.

• 클러스터 이름 또는 NetBIOS 이름, 정규화된 DNS 이름 또는 IP 주소로 표현된 클러스터 노드 중 하나를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 이렇게 하면 RPC 클러스터 핸들이 생성됩니다.
• NULL - 로컬 컴퓨터가 속한 클러스터에 대한 LPC 핸들을 생성합니다.

[in] DesiredAccess

요청된 액세스 권한입니다. GENERIC_READ(0x80000000), GENERIC_ALL(0x10000000) 또는 MAXIMUM_ALLOWED(0x02000000)의 조합일 수 있습니다. 이 값이 0이고 정의되지 않은 오류가 반환될 수 있습니다. GENERIC_ALL 사용하는 것은 OpenCluster를 호출하는 것과 동일합니다.

[out, optional] GrantedAccess

부여된 액세스 권한을 받을 DWORD 의 주소를 포함하는 선택적 매개 변수입니다. DesiredAccess 매개 변수가 MAXIMUM_ALLOWED(0x02000000)이면 이 매개 변수가 가리키는 DWORD에 이 사용자에게 부여된 최대 권한이 포함됩니다.

반환 값

작업이 성공하면 OpenClusterEx 는 클러스터 핸들을 반환합니다.

반환 코드/값	설명
NULL 0	작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 대상 서버가 OpenClusterEx 함수를 지원하지 않는 경우(예: 대상 서버가 Windows Server 2008 이하를 실행하는 경우) GetLastError 함수는 RPC_S_PROCNUM_OUT_OF_RANGE (1745)를 반환합니다.

설명

클러스터 핸들은 클러스터에 대한 RPC 또는 LPC 연결에 대한 정보를 저장하는 내부적으로 정의된 구조체에 대한 포인터입니다. 클러스터 핸들에서 가져온 모든 개체 핸들은 클러스터 구조에 저장된 RPC 또는 LPC 세션 데이터와 연결됩니다. RPC 및 LPC 핸들을 결합하거나 다른 컨텍스트에서 가져온 핸들을 사용하면 예외 또는 기타 예측할 수 없는 결과가 발생할 수 있습니다. 자세한 내용은 LPC 및 RPC 핸들을 참조하세요.

클러스터 핸들로 완료되면 CloseCluster 를 호출하여 모든 메모리가 해제되고 연결이 완전히 종료되도록 하는 것이 중요합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
대상 플랫폼	Windows
헤더	clusapi.h
라이브러리	ClusAPI.lib
DLL	ClusAPI.dll