Funzione PssWalkSnapshot (processsnapshot.h)

Articolo
08/25/2023

Restituisce informazioni dalla posizione corrente della passeggiata e fa avanzare il marcatore della passeggiata alla posizione successiva.

Sintassi

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

Parametri

[in] SnapshotHandle

Handle per lo snapshot.

[in] InformationClass

Tipo di informazioni da restituire. Per altre informazioni, vedere PSS_WALK_INFORMATION_CLASS.

[in] WalkMarkerHandle

Handle per un indicatore di marcia. L'indicatore di marcia indica la posizione della passeggiata da cui restituire i dati. PssWalkSnapshot fa avanzare il marcatore della passeggiata fino alla posizione temporale successiva prima di tornare al chiamante.

[out] Buffer

Informazioni sullo snapshot restituite da questa funzione.

[in] BufferLength

Dimensioni di Buffer, in byte.

Valore restituito

Questa funzione restituisce ERROR_SUCCESS in caso di esito positivo o di uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_BAD_LENGTH	La lunghezza specificata del buffer non è valida.
ERROR_INVALID_HANDLE	L'handle specificato non è valido.
ERROR_INVALID_PARAMETER	La classe di informazioni specificata non è valida.
ERROR_MORE_DATA	Il buffer è NULL e sono presenti dati nella posizione corrente da restituire.
ERROR_NO_MORE_ITEMS	La procedura è stata completata e non ci sono più elementi da restituire.
ERROR_NOT_FOUND	Le informazioni richieste non si trovano nello snapshot.

Tutti i codici di errore sono definiti in winerror.h. Usare FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere un messaggio per un codice di errore.

Commenti

Per i tipi di dati snapshot con un numero variabile di istanze all'interno di uno snapshot, usare la funzione PssWalkSnapshot per ottenere le istanze una dopo l'altra. Impostare il parametro InformationClass per specificare il tipo di dati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	processsnapshot.h
DLL	Kernel32.dll

Vedere anche

Creazione di snapshot del processo

Condividi tramite