지정된 클러스터의 모든 리소스를 열거하고 각 리소스에 대해 사용자 정의 작업을 시작합니다. PRESUTIL_ENUM_RESOURCES_EX2 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ResUtilEnumResourcesEx2(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter,
[in] DWORD dwDesiredAccess
);
매개 변수
[in] hCluster
열거할 리소스가 포함된 클러스터에 대한 핸들입니다.
[in, optional] hSelf
클러스터 리소스에 대한 선택적 핸들입니다. hSelf로 식별된 리소스에 대해 콜백 함수가 호출되지 않습니다.
[in] lpszResTypeName
열거할 리소스의 scope 범위를 좁히는 리소스 종류 이름에 대한 선택적 포인터입니다. lpszResTypeName을 지정하면 지정된 형식의 리소스만 열거됩니다.
[in] pResCallBack
열거된 각 리소스에 대해 호출되는 사용자 정의 함수에 대한 포인터입니다. 이 함수는 ResourceCallbackEx 콜백 함수의 정의를 준수해야 합니다(매개 변수 이름은 정의의 일부가 아니며 명확성을 위해 여기에 추가됨).
DWORD (*LPRESOURCE_CALLBACK_EX)(
HCLUSTER hCluster,
HRESOURCE hSelf,
HRESOURCE hEnum,
PVOID pParameter
);
hCluster
[in] ResUtilEnumResourcesEx에 전달된 hCluster 매개 변수입니다.
hSelf
[in] ResUtilEnumResourcesEx에 전달된 hSelf 매개 변수입니다. hSelf 및 hEnum이 동일한 리소스를 참조할 때 콜백 함수는 호출되지 않습니다.
hEnum
[in] 현재 열거 중인 리소스에 대한 핸들입니다. ResUtilEnumResourcesEx 가 열리고 이 핸들을 자동으로 닫습니다.
pParameter
[in] 모든 종류의 데이터를 콜백 함수에 전달할 수 있는 제네릭 버퍼입니다.
[in] pParameter
모든 종류의 데이터를 콜백 함수에 전달할 수 있는 제네릭 버퍼입니다. ResUtilEnumResourcesEx 는 이 매개 변수를 전혀 사용하지 않으며 단순히 포인터를 콜백 함수에 전달합니다. 매개 변수에 대해 NULL 을 전달할 수 있는지 여부는 콜백 함수가 구현되는 방법에 따라 달라집니다.
[in] dwDesiredAccess
요청된 액세스 권한입니다. GENERIC_READ( 0x80000000), GENERIC_ALL ( 0x10000000 ) 또는 MAXIMUM_ALLOWED(0x02000000 )의 조합일 수 있습니다. 이 값이 0이면 정의되지 않은 오류가 반환될 수 있습니다. GENERIC_ALL 사용하는 것은 ResUtilEnumResourcesEx를 호출하는 것과 동일합니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 열거형을 즉시 중지하고 콜백 함수에서 반환된 값을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |