PssQuerySnapshot, fonction (processsnapshot.h)

Article
03/13/2024

Interroge le instantané.

Syntaxe

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

Paramètres

[in] SnapshotHandle

Handle de l’instantané à interroger.

[in] InformationClass

Membre énumérateur qui sélectionne les informations à interroger. Pour plus d’informations, consultez PSS_QUERY_INFORMATION_CLASS.

[out] Buffer

Informations fournies par cette fonction.

[in] BufferLength

Taille de Buffer, en octets.

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_BAD_LENGTH	La longueur de la mémoire tampon spécifiée n’est pas valide.
ERROR_INVALID_HANDLE	Le handle spécifié n’est pas valide.
ERROR_INVALID_PARAMETER	La classe d’informations spécifiée n’est pas valide.
ERROR_NOT_FOUND	Les informations demandées ne sont pas dans le instantané.

Tous les codes d’erreur sont définis dans winerror.h. Utilisez FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir un message pour un code d’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	processsnapshot.h
DLL	Kernel32.dll

Voir aussi

Traiter la capture instantanée