Функция обратного вызова ENUMRESTYPEPROCW (libloaderapi.h)

Статья
08/24/2023

Определяемая приложением функция обратного вызова, используемая с функциями EnumResourceTypes и EnumResourceTypesEx . Он получает типы ресурсов. Тип ENUMRESTYPEPROC определяет указатель на эту функцию обратного вызова. EnumResTypeProc — это заполнитель для имени функции, определяемой приложением.

Синтаксис

ENUMRESTYPEPROCW Enumrestypeprocw;

BOOL Enumrestypeprocw(
  [in, optional] HMODULE hModule,
                 LPWSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

Параметры

[in, optional] hModule

Тип: HMODULE

Дескриптор модуля, исполняемый файл которого содержит ресурсы, для которых необходимо перечислить типы. Если этот параметр имеет значение NULL, функция перечисляет типы ресурсов в модуле, используемом для создания текущего процесса.

lpType

Тип: LPTSTR

Тип ресурса, для которого выполняется перечисление типа.

Кроме того, вместо указателя этот параметр может быть MAKEINTRESOURCE(ID), где ID — это целочисленный идентификатор заданного типа ресурса. Сведения о стандартных типах ресурсов см. в разделе Типы ресурсов. Дополнительные сведения см. в разделе Примечания ниже.

[in] lParam

Тип: LONG_PTR

Определяемый приложением параметр, передаваемый в функцию EnumResourceTypes или EnumResourceTypesEx . Этот параметр можно использовать при проверке ошибок.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE для продолжения перечисления или ЗНАЧЕНИЕ FALSE для остановки перечисления.

Если IS_INTRESOURCE(lpszType) имеет значение TRUE, то lpszType задает целочисленный идентификатор заданного типа ресурса. В противном случае это указатель на строку, завершаемую null. Если первым символом строки является знак фунта (#), то остальные символы представляют десятичное число, задающее целочисленный идентификатор типа ресурса. Например, строка "No 258" представляет идентификатор 258.

Приложение должно зарегистрировать эту функцию, передав ее адрес функции EnumResourceTypes или EnumResourceTypesEx .

Если функция обратного вызова возвращает значение FALSE, то EnumResourceTypes или EnumResourceTypesEx остановит перечисление и вернет значение FALSE. В Windows XP и более ранних версиях значение, полученное из GetLastError , будет ERROR_SUCCESS; Начиная с Windows Vista последнее значение ошибки будет ERROR_RESOURCE_ENUM_USER_STOP.

Примечание

Заголовок libloaderapi.h определяет ENUMRESTYPEPROC в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	libloaderapi.h (включая Windows.h)