ENUMRESTYPEPROCA 回调函数 (libloaderapi.h)

项目
08/24/2023

与 EnumResourceTypes 和 EnumResourceTypesEx 函数一起使用的应用程序定义的回调函数。它接收资源类型。 ENUMRESTYPEPROC 类型定义指向此回调函数的指针。 EnumResTypeProc 是应用程序定义的函数名称的占位符。

语法

ENUMRESTYPEPROCA Enumrestypeproca;

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

parameters

[in, optional] hModule

类型： HMODULE

模块的句柄，其可执行文件包含要枚举其类型的资源。如果此参数为 NULL，则该函数枚举模块中用于创建当前进程的资源类型。

lpType

类型： LPTSTR

要为其枚举类型的资源类型。

或者，此参数可以是 MAKEINTRESOURCE (ID) ，其中 ID 是给定资源类型的整数标识符，而不是指针。有关标准资源类型，请参阅资源类型。有关详细信息，请参阅下面的“备注”部分。

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

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	libloaderapi.h (包括 Windows.h)