Funzione PssWalkSnapshot (processsnapshot.h)

Articolo
02/23/2025

Restituisce informazioni dalla posizione corrente della passeggiata e sposta il marcatore di marcia verso la 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 devono essere restituiti i dati. PssWalkSnapshot fa avanzare il marcatore di marcia 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 del buffer specificata non è valida.
ERROR_INVALID_HANDLE	L'handle specificato non è valido.
ERROR_INVALID_PARAMETER	La classe di informazioni specificata non è valida.
ERROR_MORE_DATA	buffer è NULLe sono presenti dati nella posizione corrente da restituire.
ERROR_NO_MORE_ITEMS	La procedura è stata completata e non ci sono altri 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.

Osservazioni

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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8.1 [solo app desktop]
server minimo supportato	Windows Server 2012 R2 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	processsnapshot.h
dll	Kernel32.dll

Vedere anche

processo di snapshot

Condividi tramite