Функция ResUtilEnumResourcesEx (resapi.h)
Перечисляет все ресурсы в указанном кластере и инициирует определяемую пользователем операцию для каждого ресурса. Тип 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
Необязательный указатель на имя типа ресурса, которое сужает область ресурсов для перечисления. Если указан параметр lpszResTypeName , перечисляются только ресурсы указанного типа.
[in] pResCallBack
Указатель на определяемую пользователем функцию, которая вызывается для каждого перечисляемого ресурса. Эта функция должна соответствовать определению функции обратного вызова ResourceCallbackEx . Обратите внимание, что имена параметров не являются частью определения; они были добавлены сюда для ясности.
DWORD (*LPRESOURCE_CALLBACK_EX)(
HCLUSTER hCluster,
HRESOURCE hSelf,
HRESOURCE hEnum,
PVOID pParameter
);
hCluster
Параметр hCluster , передаваемый в ResUtilEnumResourcesEx.
hSelf
Параметр hSelf , передаваемый в ResUtilEnumResourcesEx. Обратите внимание, что функция обратного вызова никогда не вызывается, если hSelf и hEnum ссылаются на один и тот же ресурс.
hEnum
Дескриптор для ресурса, который в настоящее время перечисляется. ResUtilEnumResourcesEx открывает и закрывает этот дескриптор автоматически.
pParameter
Универсальный буфер, позволяющий передавать любые данные в функцию обратного вызова.
[in] pParameter
Универсальный буфер, позволяющий передавать любые данные в функцию обратного вызова. ResUtilEnumResourcesEx вообще не использует этот параметр; он просто передает указатель на функцию обратного вызова. Можно ли передать значение NULL для параметра, зависит от того, как реализована функция обратного вызова.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция немедленно останавливает перечисление и возвращает значение, возвращаемое функцией обратного вызова.
Комментарии
ResUtilEnumResourcesEx — это удобная и простая в использовании альтернатива функции ClusterResourceEnum .
Примеры
См. пример resUtilEnumResources.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Datacenter, Windows Server 2008 Корпоративная |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |