OpenClusterNetworkEx 함수(clusapi.h)

네트워크에 대한 연결을 열고 해당 네트워크에 대한 핸들을 반환합니다.

구문

HNETWORK OpenClusterNetworkEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNetworkName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

매개 변수

[in] hCluster

클러스터에 대한 핸들입니다.

[in, optional] lpszNetworkName

기존 네트워크의 이름에 대한 포인터입니다.

[in] dwDesiredAccess

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

[out, optional] lpdwGrantedAccess

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

반환 값

작업이 성공하면 OpenClusterNetworkEx 는 네트워크 핸들을 반환합니다.

반환 코드	설명
NULL	작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 대상 서버가 OpenClusterNetworkEx 함수를 지원하지 않는 경우(예: 대상 서버가 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

추가 정보

CloseClusterNetwork

장애 조치(failover) 클러스터 네트워크 관리 함수

OpenClusterNetwork