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

Buffer 的大小，以位元組為單位。

傳回值

此函式會 傳 回成功或下列其中一個錯誤碼ERROR_SUCCESS。

傳回碼 Description
ERROR_BAD_LENGTH
 指定的緩衝區長度無效。
ERROR_INVALID_HANDLE
 指定的句柄無效。
ERROR_INVALID_PARAMETER
 指定的資訊類別無效。
ERROR_MORE_DATA
 緩衝區 為 NULL，且目前位置有要傳回的數據。
ERROR_NO_MORE_ITEMS
 此逐步解說已完成，而且沒有其他專案可傳回。
ERROR_NOT_FOUND
 所要求的資訊不在快照集內。
 

所有錯誤碼都定義在 winerror.h 中。 使用 FormatMessage 搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤碼的訊息。

備註

對於快照集內實例數目可變的快照集數據類型，您可以使用 PssWalkSnapshot 函式來逐一取得實例。 您可以設定 InformationClass 參數來指定資料類型。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 processsnapshot.h
DLL Kernel32.dll

另請參閱

處理快照集