Função PssQuerySnapshot (processsnapshot.h)

Consulta o instantâneo.

Sintaxe

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

Parâmetros

[in] SnapshotHandle

Um identificador para o instantâneo a ser consultado.

[in] InformationClass

Um membro do enumerador que seleciona quais informações consultar. Para obter mais informações, consulte PSS_QUERY_INFORMATION_CLASS.

[out] Buffer

As informações que essa função fornece.

[in] BufferLength

O tamanho do Buffer, em bytes.

Retornar valor

Essa função retorna ERROR_SUCCESS em caso de êxito ou um dos códigos de erro a seguir.

Código de retorno	Descrição
ERROR_BAD_LENGTH	O comprimento do buffer especificado é inválido.
ERROR_INVALID_HANDLE	O identificador especificado é inválido.
ERROR_INVALID_PARAMETER	A classe de informações especificada é inválida.
ERROR_NOT_FOUND	As informações solicitadas não estão no instantâneo.

 

Todos os códigos de erro são definidos em winerror.h. Use FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma mensagem para um código de erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	processsnapshot.h
DLL	Kernel32.dll

Confira também

Processamento de instantâneos