ResUtilGetResourceDependency 함수(resapi.h)

지정된 리소스의 종속성을 열거하고 지정된 형식의 종속성에 대한 핸들을 반환합니다. PRESUTIL_GET_RESOURCE_DEPENDENCY 형식은 이 함수에 대한 포인터를 정의합니다.

구문

HRESOURCE ResUtilGetResourceDependency(
  [in] HANDLE  hSelf,
  [in] LPCWSTR lpszResourceType
);

매개 변수

[in] hSelf

종속 리소스에 대한 핸들입니다. 이 리소스는 하나 이상의 리소스에 따라 달라집니다.

[in] lpszResourceType

반환할 종속성의 리소스 유형을 지정하는 Null로 종료된 유니코드 문자열입니다.

반환 값

작업이 성공하면 함수는 hSelf 로 지정된 리소스가 의존하는 리소스 중 하나에 대한 핸들을 반환합니다. 호출자는 CloseClusterResource를 호출하여 핸들을 닫습니다.

작업이 실패하면 함수는 NULL을 반환합니다. 자세한 내용은 GetLastError 함수를 호출합니다.

설명

ResUtilGetResourceDependency, ResUtilGetResourceDependencyByName 및 ResUtilGetResourceNameDependency 함수는 모두 특정 리소스 유형의 종속성에 대한 액세스를 제공한다는 측면에서 매우 유사합니다. 다음 표에서는 함수 간의 차이점을 요약합니다.

함수	종속 리소스를 지정하는 방법	클러스터 핸들 필요
ResUtilGetResourceDependency	리소스 핸들	No
ResUtilGetResourceDependencyByName	리소스 핸들	Yes
ResUtilGetResourceNameDependency	리소스 이름	No

리소스 DLL 진입점 함수에서 ResUtilGetResourceDependency 를 호출하지 마세요. ResUtilGetResourceDependency 는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.

예제

다음 예제와 같이 리소스 A가 물리적 디스크 리소스에 종속된다는 것을 알고 있는 경우 ResUtilGetResourceDependency 를 사용하여 종속성에 대한 핸들을 가져올 수 있습니다.

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

//
// Resource A depends on a Physical Disk resource.
// Get a handle to that resource.
//
HRESOURCE hResA = OpenClusterResource( hCluster, lpszResName );

HRESOURCE hResD = ResUtilGetResourceDependency(
                        hResA,
                        L"Physical Disk" );

// Close handles and free memory.

요구 사항

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