Функция ResUtilEnumResourcesEx2 (resapi.h)

Статья
08/25/2023

Перечисляет все ресурсы в указанном кластере и инициирует определяемую пользователем операцию для каждого ресурса. Тип 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

Необязательный указатель на имя типа ресурса, которое сужает область ресурсов для перечисления. Если указан параметр lpszResTypeName , перечисляются только ресурсы указанного типа.

[in] pResCallBack

Указатель на определяемую пользователем функцию, которая будет вызываться для каждого перечисляемого ресурса. Эта функция должна соответствовать определению функции обратного вызова ResourceCallbackEx (обратите внимание, что имена параметров не являются частью определения; они были добавлены здесь для ясности):

DWORD (*LPRESOURCE_CALLBACK_EX)( 
  HCLUSTER hCluster,
  HRESOURCE hSelf, 
  HRESOURCE hEnum, 
  PVOID pParameter 
);

hCluster

[in] Параметр hCluster, передаваемый в ResUtilEnumResourcesEx.

hSelf

[in] Параметр hSelf, передаваемый в ResUtilEnumResourcesEx. Обратите внимание, что функция обратного вызова никогда не вызывается, если 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
Header	resapi.h
Библиотека	ResUtils.lib
DLL	ResUtils.dll

См. также раздел

Функции служебной программы ресурсов

Поделиться через