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

Статья
11/20/2024

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

Синтаксис

ENUMRESTYPEPROCA Enumrestypeproca;

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

Параметры

[in, optional] hModule

Тип: HMODULE

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

lpType

Тип: LPTSTR

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

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

[in] lParam

Тип: LONG_PTR

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

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

Тип: BOOL

Возвращает TRUE для продолжения перечисления или FALSE для остановки перечисления.

Замечания

Если IS_INTRESOURCE(lpszType) true, то lpszType указывает целый идентификатор заданного типа ресурса. В противном случае это указатель на строку, завершаемую значением NULL. Если первым символом строки является знак фунта (#), остальные символы представляют десятичное число, указывающее целочисленный идентификатор типа ресурса. Например, строка "#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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	libloaderapi.h (включая Windows.h)