OpenClusterResourceEx 함수(clusapi.h)
리소스를 열고 해당 리소스 에 대한 핸들을 반환합니다.
구문
HRESOURCE OpenClusterResourceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszResourceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
매개 변수
[in] hCluster
클러스터에 대한 핸들입니다.
[in, optional] lpszResourceName
열 리소스의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
리소스 이름은 대/소문자를 구분하지 않습니다. 리소스 이름은 클러스터 내에서 고유해야 합니다. 이름은 리소스를 만들 때 설정되며 SetClusterResourceName 함수를 사용하여 변경할 수 있습니다.
[in] dwDesiredAccess
요청된 액세스 권한입니다. GENERIC_READ(0x80000000), GENERIC_ALL(0x10000000) 또는 MAXIMUM_ALLOWED(0x02000000)의 조합일 수 있습니다. 이 값이 0이고 정의되지 않은 오류가 반환될 수 있습니다. GENERIC_ALL 사용하는 것은 OpenClusterResource를 호출하는 것과 동일합니다.
[out, optional] lpdwGrantedAccess
부여된 액세스 권한을 받을 DWORD 의 주소를 포함하는 선택적 매개 변수입니다. DesiredAccess 매개 변수가 MAXIMUM_ALLOWED(0x02000000)이면 이 매개 변수가 가리키는 DWORD에 이 사용자에게 부여된 최대 권한이 포함됩니다.
반환 값
작업이 성공하면 OpenClusterResourceEx 는 열린 리소스에 대한 핸들을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 대상 서버가 OpenClusterResourceEx 함수를 지원하지 않는 경우(예: 대상 서버가 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 |