지정된 클러스터의 모든 리소스를 열거하고 각 리소스에 대해 사용자 정의 작업을 시작합니다. PRESUTIL_ENUM_RESOURCES_EX 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ResUtilEnumResourcesEx(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter
);
매개 변수
[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
ResUtilEnumResourcesEx에 전달되는 hCluster 매개 변수입니다.
hSelf
ResUtilEnumResourcesEx에 전달되는 hSelf 매개 변수입니다. hSelf 및 hEnum이 동일한 리소스를 참조할 때 콜백 함수는 호출되지 않습니다.
hEnum
현재 열거 중인 리소스에 대한 핸들입니다. ResUtilEnumResourcesEx 가 열리고 이 핸들이 자동으로 닫힙니다.
pParameter
콜백 함수에 모든 종류의 데이터를 전달할 수 있는 제네릭 버퍼입니다.
[in] pParameter
콜백 함수에 모든 종류의 데이터를 전달할 수 있는 제네릭 버퍼입니다. ResUtilEnumResourcesEx 는 이 매개 변수를 전혀 사용하지 않습니다. 단지 포인터를 콜백 함수에 전달합니다. 매개 변수에 대해 NULL 을 전달할 수 있는지 여부는 콜백 함수가 구현되는 방법에 따라 달라집니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 열거형을 즉시 중지하고 콜백 함수에서 반환되는 값을 반환합니다.
설명
ResUtilEnumResourcesEx 는 ClusterResourceEnum 함수 대신 편리하고 사용하기 쉬운 대안입니다.
예제
ResUtilEnumResources의 예제를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |