EnumResourceTypesExW 函数 (libloaderapi.h)

项目
08/24/2023

枚举与指定的二进制模块关联的资源类型。搜索可以包括非特定语言的可移植可执行文件 (LN 文件) 及其关联的 .mui 文件。或者，它可以限制为任何类型的单个二进制模块，或限制为与单个 LN 文件关联的 .mui 文件。搜索还可以限制为单个关联的 .mui 文件，该文件包含特定语言的资源。

对于找到的每个资源类型， EnumResourceTypesEx 调用应用程序定义的回调函数 lpEnumFunc，传递它找到的资源类型以及传递给 EnumResourceTypesEx 的各种其他参数。

语法

BOOL EnumResourceTypesExW(
  [in, optional] HMODULE          hModule,
  [in]           ENUMRESTYPEPROCW lpEnumFunc,
  [in]           LONG_PTR         lParam,
  [in]           DWORD            dwFlags,
  [in]           LANGID           LangId
);

parameters

[in, optional] hModule

类型： HMODULE

要搜索的模块的句柄。通常，这是一个 LN 文件，如果设置了 标志RESOURCE_ENUM_MUI ，则可以在搜索中包含相应的 .mui 文件。或者，这可以是 .mui 文件或其他 LN 文件的句柄。

如果此参数为 NULL，则等效于将句柄传递到用于创建当前进程的模块。

[in] lpEnumFunc

类型： ENUMRESTYPEPROC

指向要为每个枚举资源类型调用的回调函数的指针。有关详细信息，请参阅 EnumResTypeProc。

[in] lParam

类型： LONG_PTR

传递给回调函数的应用程序定义值。

[in] dwFlags

类型：DWORD

要搜索的文件类型。支持以下值：请注意，如果 dwFlags 为零，则假定指定 RESOURCE_ENUM_LN 和 RESOURCE_ENUM_MUI 标志。

值	含义
RESOURCE_ENUM_MUI 0x0002	按照常用的资源加载程序策略 (请参阅用户界面语言管理) ，在与 hModule 指定的文件关联的其中一个 .mui 文件中搜索资源类型。或者，如果 LangId 为非零值，则仅搜索 LangId 指定的语言的 .mui 文件。通常，仅当 hModule 引用 LN 文件时，才应使用此标志。如果 hModule 引用 .mui 文件，则该文件实际上由 RESOURCE_ENUM_LN 标志覆盖，尽管标志的名称为。
RESOURCE_ENUM_LN 0x0001	仅搜索 hModule 指定的文件，无论该文件是 LN 文件还是 .mui 文件。
RESOURCE_ENUM_VALIDATE 0x0008	执行枚举时，对资源节及其在 PE 标头中的引用执行额外验证，以确保资源格式正确。验证为枚举的每个类型设置的最大限制为 260 个字符。

[in] LangId

类型： LANGID

用于在 MUI 模块中筛选搜索的语言。仅当在 dwFlags 中设置了RESOURCE_ENUM_MUI标志时，才使用此参数。如果指定了零，则搜索中包括与当前语言首选项匹配的所有 .mui 文件，请遵循常用的资源加载程序策略 (请参阅用户界面语言管理) 。如果指定了非零 LangId ，则搜索的唯一 .mui 文件将是与指定的 LangId 匹配的文件。

返回值

类型： BOOL

如果成功，则返回 TRUE ;如果函数找不到指定类型的资源，则返回 FALSE;如果函数因其他原因而失败，则返回 FALSE 。要获得更多的错误信息，请调用 GetLastError。

注解

EnumResourceTypesEx 函数继续枚举资源类型，直到回调函数返回 FALSE 或已枚举所有资源类型。

如果 hModule 指定 LN 文件，并且同时选择了这两个标志，则枚举的类型对应于驻留在 LN 文件或与之关联的 .mui 文件中的资源。如果未找到 .mui 文件，则仅返回 LN 文件中的类型。找到一个适当的 .mui 文件后，搜索将不会继续，因为与单个 LN 文件对应的所有 .mui 文件具有相同的资源类型。

如果 dwFlags 和 LangId 均为零，则该函数的行为类似于 EnumResourceTypes。

如果 LangId 为非零值，则仅搜索与该语言标识符对应的 .mui 文件。不会使用语言回退。如果该语言的 .mui 文件不存在，则枚举将为空 (除非 LN 文件中存在该语言的资源，并且标志设置为搜索 LN 文件以及) 。

枚举绝不包含重复项：如果 LN 文件和 .mui 文件中都包含特定语言的资源，则类型将仅枚举一次。

示例

有关示例，请参阅创建资源列表。

注意

libloaderapi.h 标头将 EnumResourceTypesEx 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	libloaderapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll