ENUMRESNAMEPROCA 回调函数 (libloaderapi.h)

项目
08/24/2023

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

语法

ENUMRESNAMEPROCA Enumresnameproca;

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

parameters

[in, optional] hModule

类型： HMODULE

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

lpType

类型： LPCTSTR

要为其枚举名称的资源的类型。或者，此参数可以是 MAKEINTRESOURCE(ID)（而不是指针），其中 ID 是表示预定义资源类型的整数值。有关标准资源类型，请参阅资源类型。有关详细信息，请参阅下面的“备注”部分。

lpName

类型： LPTSTR

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

[in] lParam

类型： LONG_PTR

传递给 EnumResourceNames 或 EnumResourceNamesEx 函数的应用程序定义参数。此参数可用于错误检查。

返回值

类型： BOOL

返回 TRUE 以继续枚举，返回 FALSE 以停止枚举。

注解

如果 IS_INTRESOURCE (lpszType) 为 TRUE，则 lpszType 指定给定资源类型的整数标识符。否则，它是指向以 null 结尾的字符串的指针。如果字符串的第一个字符是井号 (#) ，则其余字符表示指定资源类型的整数标识符的十进制数。例如，字符串“#258”表示标识符 258。

同样，如果 IS_INTRESOURCE (lpszName) 为 TRUE，则 lpszName 指定给定资源的整数标识符。否则，它是指向以 null 结尾的字符串的指针。如果字符串的第一个字符是井号 (#) ，则其余字符表示指定资源的整数标识符的十进制数。

应用程序必须通过将地址传递给 EnumResourceNames 或 EnumResourceNamesEx 函数来注册此函数。

如果回调函数返回 FALSE，则 EnumResourceNames 或 EnumResourceNamesEx 将停止枚举并返回 FALSE。在 Windows XP 和更早版本中，将从 GetLastError 获取的值 ERROR_SUCCESS;从 Windows Vista 开始，将 ERROR_RESOURCE_ENUM_USER_STOP最后一个错误值。

注意

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

要求


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