Функция 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), или пока все ресурсы не будут перечислены.
Пример
Пример смотри в статье Создание списка ресурсов.
Смотри такжеОбзор Ресурсы, Функции, используемые ресурсами, EnumResNameProc, EnumResourceLanguages, EnumResourceTypes
|
Размещение и совместимость 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 |
Нет |
|
Замечания по платформе |
Не имеется |