通过

PssWalkSnapshot 函数 (processsnapshot.h)

  • 项目

从当前步行位置返回信息，并将步行标记推进到下一个位置。

语法

DWORD PssWalkSnapshot(
  [in]  HPSS                       SnapshotHandle,
  [in]  PSS_WALK_INFORMATION_CLASS InformationClass,
  [in]  HPSSWALK                   WalkMarkerHandle,
  [out] void                       *Buffer,
  [in]  DWORD                      BufferLength
);

参数

[in] SnapshotHandle

快照的句柄。

[in] InformationClass

要返回的信息类型。 有关详细信息，请参阅 PSS_WALK_INFORMATION_CLASS。

[in] WalkMarkerHandle

步行标记的句柄。 步行标记指示从中返回数据的步行位置。 PssWalkSnapshot 在返回到调用方之前，按时间顺序将步行标记推进到下一个步行位置。

[out] Buffer

此函数返回快照信息。

[in] BufferLength

缓冲区的大小（以字节为单位）。

返回值

此函数返回 成功时ERROR_SUCCESS 或以下错误代码之一。

返回代码 说明
ERROR_BAD_LENGTH
 指定的缓冲区长度无效。
ERROR_INVALID_HANDLE
 指定的句柄无效。
ERROR_INVALID_PARAMETER
 指定的信息类无效。
ERROR_MORE_DATA
 缓冲区 为 NULL，当前位置有数据要返回。
ERROR_NO_MORE_ITEMS
 演练已完成，没有其他项目可返回。
ERROR_NOT_FOUND
 请求的信息不在快照中。
 

所有错误代码都在 winerror.h 中定义。 使用带有 FORMAT_MESSAGE_FROM_SYSTEM 标志的 FormatMessage 获取错误代码的消息。

注解

对于快照中实例数可变的快照数据类型，可以使用 PssWalkSnapshot 函数逐个获取实例。 设置 InformationClass 参数以指定数据类型。

要求

要求 值
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 processsnapshot.h
DLL Kernel32.dll

另请参阅

进程快照