Функция EnumResourceTypesA (winbase.h)
Перечисляет типы ресурсов в двоичном модуле. Начиная с Windows Vista, это обычно нейтрализуемый языком переносимый исполняемый (LN-файл), а перечисление также включает ресурсы из одного из соответствующих файлов ресурсов для конкретного языка (мюи-файлы), если он существует, которые содержат локализованные языковые ресурсы. Кроме того, можно использовать hModule для указания mui-файла, в этом случае выполняется поиск только для типов ресурсов.
Кроме того, приложения могут вызывать EnumResourceTypesEx, что обеспечивает более точный контроль над перечислением файлов ресурсов.
Синтаксис
BOOL EnumResourceTypesA(
[in, optional] HMODULE hModule,
[in] ENUMRESTYPEPROCA lpEnumFunc,
[in] LONG_PTR lParam
);
Параметры
[in, optional] hModule
Тип: HMODULE
Дескриптор модуля для поиска. Этот дескриптор должен быть получен через LoadLibrary или LoadLibraryEx.
Дополнительные сведения см. в примечаниях.
Если этот параметр null, то это эквивалентно передаче дескриптора модулю, используемому для создания текущего процесса.
[in] lpEnumFunc
Тип: ENUMRESTYPEPROC
Указатель на функцию обратного вызова для каждого перечисленного типа ресурса. Дополнительные сведения см. в функции EnumResTypeProc.
[in] lParam
Тип: LONG_PTR
Определяемое приложением значение, переданное функции обратного вызова.
Возвращаемое значение
Тип: BOOL
Возвращает TRUE в случае успешного выполнения; в противном случае FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Для каждого найденного типа ресурсов EnumResourceTypes вызывает определяемую приложением функцию обратного вызова lpEnumFunc, передавая каждый тип ресурса, который он находит, а также различные другие параметры, переданные EnumResourceTypes.
EnumResourceTypes продолжает перечислять типы ресурсов, пока функция обратного вызова не возвращает false или все типы ресурсов.
Начиная с Windows Vista, если hModule указывает LN-файл, то перечисленные типы соответствуют ресурсам, которые находятся в LN-файле и в файле MUI, связанном с ним. Если файлы MUI не найдены, возвращаются только типы из LN-файла. Порядок поиска .mui-файлов — это обычный порядок поиска загрузчика ресурсов; Дополнительные сведения см. в управления языком пользовательского интерфейса. После того как найден один соответствующий MUI-файл, поиск не продолжается дальше к другим файлам MUI, связанным с LN-файлом, так как все ФАЙЛЫ MUI, соответствующие одному LN-файлу, имеют одинаковый набор типов ресурсов.
Перечисление никогда не включает дубликаты: если заданный тип ресурса содержится как в LN-файле, так и в mui-файле, тип перечисляется только один раз.
Примеры
Пример см. в разделе Создание списка ресурсов.
Заметка
Заголовок winbase.h определяет EnumResourceTypes как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
целевая платформа | Виндоус |
заголовка | winbase.h (включая Windows.h) |
библиотеки |
Kernel32.lib |
DLL | Kernel32.dll |
См. также
концептуальные
Справочник