Функция EnumResourceNames

Функция EnumResourceNames ищет модуль каждого ресурса указанного типа и передает или имя, или идентификатор (ID) каждого ресурса, местонахождение которого она установила,  в определяемую программой функцию повторного вызова.

Синтаксис

BOOL EnumResourceNames(
    HMODULE hModule,
    LPCTSTR lpszType,
    ENUMRESNAMEPROC lpEnumFunc,
    LONG_PTR lParam
);

Параметры

hModule

[in] Дескриптор модуля, содержащий исполняемый файл, ресурсы которого должны быть перечислены. Если этот параметр - ПУСТО (NULL), функция перечисляет ресурсы в модуле, используемом, чтобы создать текущий процесс.

lpszType

[in] Указатель на символьную строку с нулем в конце, определяющую тип перечисляемых ресурсов. Типы стандартных ресурсов смотри в статье  Типы ресурсов.

lpEnumFunc

[in] Указатель на функцию повторного вызова, вызываемую для каждого перечисляемого имени ресурса. Для получения дополнительной информации, см. функцию EnumResNameProc.

lParam

[in] Устанавливает определяемое программой значение, которое передается в функцию повторного вызова. Этот параметр может использоваться в выявлении ошибок.

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

Если функция завершается успешно, возвращаемое значение не нуль.

Если функция не находит ресурс заданного типа, или если функция завершается ошибкой по другой причине, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Значение GetLastError Предназначение
NO_ERROR Windows 95/98/Me: Ресурс заданного типа найден не был.
ERROR_RESOURCE_TYPE_NOT_FOUND Windows NT/2000/XP: Ресурс заданного типа найден не был.
любые другие возвращенные значения Произошел какой-либо другой тип ошибки.

Замечания

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

Функция EnumResourceNames продолжает перечислять ресурсы до тех пор, пока функция повторного вызова не возвратит значение ЛОЖЬ (FALSE), или пока все ресурсы не будут перечислены.

Пример

Пример смотри в статье Создание списка ресурсов.

Смотри также 

Обзор Ресурсы, Функции, используемые ресурсами,   EnumResNameProcEnumResourceLanguagesEnumResourceTypes

Размещение и совместимость EnumResourceNames

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz