Edit

PssQuerySnapshot function (processsnapshot.h)

  • Article

Queries the snapshot.

Syntax

DWORD PssQuerySnapshot(
  [in]  HPSS                        SnapshotHandle,
  [in]  PSS_QUERY_INFORMATION_CLASS InformationClass,
  [out] void                        *Buffer,
  [in]  DWORD                       BufferLength
);

Parameters

[in] SnapshotHandle

A handle to the snapshot to query.

[in] InformationClass

An enumerator member that selects what information to query. For more information, see PSS_QUERY_INFORMATION_CLASS.

[out] Buffer

The information that this function provides.

[in] BufferLength

The size of Buffer, in bytes.

Return value

This function returns ERROR_SUCCESS on success or one of the following error codes.

Return code Description
ERROR_BAD_LENGTH
 The specified buffer length is invalid.
ERROR_INVALID_HANDLE
 The specified handle is invalid.
ERROR_INVALID_PARAMETER
 The specified information class is invalid.
ERROR_NOT_FOUND
 The requested information is not in the snapshot.
 

All error codes are defined in winerror.h. Use FormatMessage with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a message for an error code.

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps only]
Minimum supported server Windows Server 2012 R2 [desktop apps only]
Target Platform Windows
Header processsnapshot.h
DLL Kernel32.dll

See also

Process Snapshotting