EnumPageFilesA 函数 （psapi.h）

为系统中每个已安装的页面文件调用回调例程。

语法

BOOL EnumPageFilesA(
  [out] PENUM_PAGE_FILE_CALLBACKA pCallBackRoutine,
  [in]  LPVOID                    pContext
);

参数

[out] pCallBackRoutine

指向为每个页面文件调用的例程的指针。 有关详细信息，请参阅 EnumPageFilesProc。

[in] pContext

传递给回调例程的用户定义数据。

返回值

如果函数成功，则返回值 TRUE。 如果函数失败，则返回值 FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

从 Windows 7 和 Windows Server 2008 R2 开始，Psapi.h 为 PSAPI 函数建立版本号。 PSAPI 版本号会影响用于调用函数的名称和程序必须加载的库。

如果 PSAPI_VERSION 为 2 或更高版本，则此函数在 Psapi.h 中定义为 K32EnumPageFiles，并在 Kernel32.lib 和 Kernel32.dll中导出。 如果 PSAPI_VERSION 为 1，则此函数在 Psapi.h 中定义为 EnumPageFiles，并在 Psapi.lib 中导出，Psapi.dll 作为调用 K32EnumPageFiles的包装器。

必须在早期版本的 Windows 以及 Windows 7 及更高版本上运行的程序应始终将此函数调用为 EnumPageFiles。 若要确保符号的正确解析，请将 Psapi.lib 添加到 TARGETLIBS 宏中，并使用 –DPSAPI_VERSION=1 编译程序。 若要使用运行时动态链接，请加载 Psapi.dll。

注意

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

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	psapi.h
库	Windows 7 和 Windows Server 2008 R2 上的 Kernel32.lib;Windows 7 和 Windows Server 2008 R2 上的 Psapi.lib （如果 PSAPI_VERSION=1）;Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 上的 Psapi.lib
DLL	Windows 7 和 Windows Server 2008 R2 上的 Kernel32.dll;windows 7 和 Windows Server 2008 R2 上的 Psapi.dll（如果 PSAPI_VERSION=1）;Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 上的 Psapi.dll

另请参阅

EnumPageFilesProc

PSAPI 函数