PssQuerySnapshot function

Queries the snapshot.

Syntax

DWORD PssQuerySnapshot(
  HPSS                        SnapshotHandle,
  PSS_QUERY_INFORMATION_CLASS InformationClass,
  void                        *Buffer,
  DWORD                       BufferLength
);

Parameters

SnapshotHandle

A handle to the snapshot to query.

InformationClass

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

Buffer

The information that this function provides.

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

   
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