PSS_HANDLE_ENTRY structure (processsnapshot.h)

Contient des informations sur un handle retourné par PssWalkSnapshot.

Syntaxe

typedef struct {
  HANDLE           Handle;
  PSS_HANDLE_FLAGS Flags;
  PSS_OBJECT_TYPE  ObjectType;
  FILETIME         CaptureTime;
  DWORD            Attributes;
  DWORD            GrantedAccess;
  DWORD            HandleCount;
  DWORD            PointerCount;
  DWORD            PagedPoolCharge;
  DWORD            NonPagedPoolCharge;
  FILETIME         CreationTime;
  WORD             TypeNameLength;
  wchar_t const    *TypeName;
  WORD             ObjectNameLength;
  wchar_t const    *ObjectName;
  union {
    struct {
      DWORD     ExitStatus;
      void      *PebBaseAddress;
      ULONG_PTR AffinityMask;
      LONG      BasePriority;
      DWORD     ProcessId;
      DWORD     ParentProcessId;
      DWORD     Flags;
    } Process;
    struct {
      DWORD     ExitStatus;
      void      *TebBaseAddress;
      DWORD     ProcessId;
      DWORD     ThreadId;
      ULONG_PTR AffinityMask;
      int       Priority;
      int       BasePriority;
      void      *Win32StartAddress;
    } Thread;
    struct {
      LONG  CurrentCount;
      BOOL  Abandoned;
      DWORD OwnerProcessId;
      DWORD OwnerThreadId;
    } Mutant;
    struct {
      BOOL ManualReset;
      BOOL Signaled;
    } Event;
    struct {
      void          *BaseAddress;
      DWORD         AllocationAttributes;
      LARGE_INTEGER MaximumSize;
    } Section;
    struct {
      LONG CurrentCount;
      LONG MaximumCount;
    } Semaphore;
  } TypeSpecificInformation;
} PSS_HANDLE_ENTRY;

Membres

Handle

Valeur de handle.

Flags

Indicateurs qui indiquent quelles parties de cette structure sont valides. Pour plus d’informations, consultez PSS_HANDLE_FLAGS.

ObjectType

Type de l’objet auquel le handle fait référence. Pour plus d’informations, consultez PSS_OBJECT_TYPE.

CaptureTime

Heure de capture de ces informations. Pour plus d’informations, consultez FILETIME.

Attributes

Attributs.

GrantedAccess

Réservé à l’utilisation par le système d’exploitation.

HandleCount

Réservé à l’utilisation par le système d’exploitation.

PointerCount

Réservé à l’utilisation par le système d’exploitation.

PagedPoolCharge

Réservé à l’utilisation par le système d’exploitation.

NonPagedPoolCharge

Réservé à l’utilisation par le système d’exploitation.

CreationTime

Réservé à l’utilisation par le système d’exploitation.

TypeNameLength

Longueur de TypeName, en octets.

TypeName

Nom de type de l’objet référencé par ce handle. La mémoire tampon ne peut pas se terminer par un caractère NULL . Le pointeur est valide pendant toute la durée de vie du marqueur de marche passé à PssWalkSnapshot.

ObjectNameLength

Longueur d’ObjectName, en octets.

ObjectName

Spécifie le nom de l’objet référencé par ce handle. La mémoire tampon ne peut pas se terminer par un caractère NULL . Le pointeur est valide pendant toute la durée de vie du marqueur de marche passé à PssWalkSnapshot.

TypeSpecificInformation

Informations spécifiques au type.

Processus

Valide pourles PSS_OBJECT_TYPE_PROCESSObjectType = .

ExitStatus

Code de sortie du processus. Si le processus n’est pas arrêté, il est défini sur STILL_ACTIVE (259).

PebBaseAddress

Adresse du bloc d’environnement de processus (PEB). Réservé à l’utilisation par le système d’exploitation.

AffinityMask

Masque d’affinité du processus.

BasePriority

Niveau de priorité de base du processus.

ProcessId

ID de processus.

ParentProcessId

ID de processus parent.

Indicateurs

Indicateurs sur le processus. Pour plus d’informations, consultez PSS_PROCESS_FLAGS.

Thread

Valide pourles PSS_OBJECT_TYPE_THREADObjectType = .

ExitStatus

Code de sortie du processus. Si le processus n’est pas arrêté, il est défini sur STILL_ACTIVE (259).

TebBaseAddress

Adresse du bloc d’environnement de thread (TEB). Réservé à l’utilisation par le système d’exploitation.

ProcessId

ID de processus.

ThreadId

ID de thread.

AffinityMask

Masque d’affinité du processus.

Priorité

Niveau de priorité dynamique du thread.

BasePriority

Niveau de priorité de base du thread.

Win32StartAddress

Pointeur vers la procédure de thread pour le thread.

Mutant

Valide pourles PSS_OBJECT_TYPE_MUTANTObjectType = .

Currentcount

Réservé à l’utilisation par le système d’exploitation.

Abandonné

TRUE si le mutant a été abandonné (le thread propriétaire s’est arrêté sans libérer le mutex), FALSE si ce n’est pas le cas.

OwnerProcessId

ID de processus du thread propriétaire, au moment de la création de instantané et de la capture de gestion.

OwnerThreadId

ID de processus du thread propriétaire, au moment de la création de instantané et de la capture de gestion.

Événement

Valide pourles PSS_OBJECT_TYPE_EVENTObjectType = .

ManualReset

TRUE si l’événement est réinitialisé manuellement, FALSE si ce n’est pas le cas.

Signalé

TRUE si l’événement a été signalé au moment de la création de instantané et de la capture de gestion, FALSE si ce n’est pas le cas.

Section

Valide pourles PSS_OBJECT_TYPE_SECTIONObjectType = .

BaseAddress

Réservé à l’utilisation par le système d’exploitation.

AllocationAttributes

Réservé à l’utilisation par le système d’exploitation.

MaximumSize

Réservé à l’utilisation par le système d’exploitation.

TypeSpecificInformation.Process

TypeSpecificInformation.Process.ExitStatus

TypeSpecificInformation.Process.PebBaseAddress

TypeSpecificInformation.Process.AffinityMask

TypeSpecificInformation.Process.BasePriority

TypeSpecificInformation.Process.ProcessId

TypeSpecificInformation.Process.ParentProcessId

TypeSpecificInformation.Process.Flags

TypeSpecificInformation.Thread

TypeSpecificInformation.Thread.ExitStatus

TypeSpecificInformation.Thread.TebBaseAddress

TypeSpecificInformation.Thread.ProcessId

TypeSpecificInformation.Thread.ThreadId

TypeSpecificInformation.Thread.AffinityMask

TypeSpecificInformation.Thread.Priority

TypeSpecificInformation.Thread.BasePriority

TypeSpecificInformation.Thread.Win32StartAddress

TypeSpecificInformation.Mutant

TypeSpecificInformation.Mutant.CurrentCount

TypeSpecificInformation.Mutant.Abandoned

TypeSpecificInformation.Mutant.OwnerProcessId

TypeSpecificInformation.Mutant.OwnerThreadId

TypeSpecificInformation.Event

TypeSpecificInformation.Event.ManualReset

TypeSpecificInformation.Event.Signaled

TypeSpecificInformation.Section

TypeSpecificInformation.Section.BaseAddress

TypeSpecificInformation.Section.AllocationAttributes

TypeSpecificInformation.Section.MaximumSize

TypeSpecificInformation.Semaphore

TypeSpecificInformation.Semaphore.CurrentCount

TypeSpecificInformation.Semaphore.MaximumCount

Remarques

PssWalkSnapshot retourne une structure PSS_HANDLE_ENTRY lorsque le membre PSS_WALK_INFORMATION_CLASS fourni par l’appelant est PSS_WALK_HANDLES.

Configuration requise

Voir aussi

Traiter la capture instantanée