Поделиться через

структура PSS_HANDLE_ENTRY (processsnapshot.h)

  • Статья

Содержит сведения о дескрипторе, возвращенном PssWalkSnapshot.

Синтаксис

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;

Члены

Handle

Значение дескриптора.

Flags

Флаги, указывающие, какие части этой структуры являются допустимыми. Дополнительные сведения см. в разделе PSS_HANDLE_FLAGS.

ObjectType

Тип объекта, на который ссылается дескриптор. Дополнительные сведения см. в разделе PSS_OBJECT_TYPE.

CaptureTime

Время записи этих сведений. Дополнительные сведения см. в разделе FILETIME.

Attributes

Атрибуты.

GrantedAccess

Зарезервировано для использования операционной системой.

HandleCount

Зарезервировано для использования операционной системой.

PointerCount

Зарезервировано для использования операционной системой.

PagedPoolCharge

Зарезервировано для использования операционной системой.

NonPagedPoolCharge

Зарезервировано для использования операционной системой.

CreationTime

Зарезервировано для использования операционной системой.

TypeNameLength

Длина TypeName в байтах.

TypeName

Имя типа объекта, на который ссылается этот дескриптор. Буфер не может завершаться символом NULL . Указатель действителен в течение времени существования маркера перехода, переданного в PssWalkSnapshot.

ObjectNameLength

Длина ObjectName в байтах.

ObjectName

Указывает имя объекта, на который ссылается этот дескриптор. Буфер не может завершаться символом NULL . Указатель действителен в течение времени существования маркера перехода, переданного в PssWalkSnapshot.

TypeSpecificInformation

Сведения о типе.

Процесс

Допустимо дляPSS_OBJECT_TYPE_PROCESSObjectType = .

ExitStatus

Код выхода процесса. Если процесс не завершился, устанавливается значение STILL_ACTIVE (259).

PebBaseAddress

Адрес блока среды обработки (PEB). Зарезервировано для использования операционной системой.

AffinityMask

Маска сходства процесса.

BasePriority

Базовый уровень приоритета процесса.

ProcessId

Идентификатор процесса.

ParentProcessId

Идентификатор родительского процесса.

Флаги

Флаги процесса. Дополнительные сведения см. в разделе PSS_PROCESS_FLAGS.

Thread

Допустимо дляPSS_OBJECT_TYPE_THREADObjectType = .

ExitStatus

Код выхода процесса. Если процесс не завершился, устанавливается значение STILL_ACTIVE (259).

TebBaseAddress

Адрес блока среды потока (TEB). Зарезервировано для использования операционной системой.

ProcessId

Идентификатор процесса.

ThreadId

Идентификатор потока.

AffinityMask

Маска сходства процесса.

Приоритет

Динамический уровень приоритета потока.

BasePriority

Базовый уровень приоритета потока.

Win32StartAddress

Указатель на процедуру потока для потока.

Мутант

Допустимо дляPSS_OBJECT_TYPE_MUTANTObjectType = .

CurrentCount

Зарезервировано для использования операционной системой.

Abandoned

Значение TRUE , если мутант был оставлен (собственный поток завершился без освобождения мьютекса), значение FALSE , если нет.

OwnerProcessId

Идентификатор процесса владеющего потока на момент создания snapshot и отслеживания.

OwnerThreadId

Идентификатор процесса владеющего потока на момент создания snapshot и отслеживания.

Событие

Допустимо дляPSS_OBJECT_TYPE_EVENTObjectType = .

ManualReset

Значение TRUE , если событие сбрасывается вручную, значение FALSE , если нет.

Сигнал

Значение TRUE, если событие было подсовывалось во время создания snapshot и обработки записи, значение FALSE, если нет.

Section

Допустимо дляPSS_OBJECT_TYPE_SECTIONObjectType = .

BaseAddress

Зарезервировано для использования операционной системой.

AllocationAttributes

Зарезервировано для использования операционной системой.

MaximumSize

Зарезервировано для использования операционной системой.

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

Комментарии

PssWalkSnapshot возвращает структуру PSS_HANDLE_ENTRY , когда элемент PSS_WALK_INFORMATION_CLASS , который предоставляет вызывающий объект , PSS_WALK_HANDLES.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Верхняя часть processsnapshot.h

См. также раздел

Создание моментальных снимков процесса