通过

ENUMRESNAMEPROCW 回调函数 （libloaderapi.h）

  • 项目

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

语法

ENUMRESNAMEPROCW Enumresnameprocw;

BOOL Enumresnameprocw(
  [in, optional] HMODULE hModule,
                 LPCWSTR lpType,
                 LPWSTR lpName,
  [in]           LONG_PTR lParam
)
{...}

参数

[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 [仅限桌面应用]
目标平台 窗户
标头 libloaderapi.h （包括 Windows.h）

另请参阅

概念

EnumResourceNames

EnumResourceNamesEx

IS_INTRESOURCE

参考

资源