estrutura PSS_HANDLE_ENTRY (processsnapshot.h)

Contém informações sobre um identificador retornado por PssWalkSnapshot.

Sintaxe

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;

Membros

Handle

O valor do identificador.

Flags

Sinalizadores que indicam quais partes dessa estrutura são válidas. Para obter mais informações, consulte PSS_HANDLE_FLAGS.

ObjectType

O tipo do objeto que o identificador faz referência. Para obter mais informações, consulte PSS_OBJECT_TYPE.

CaptureTime

O tempo de captura dessas informações. Para obter mais informações, consulte FILETIME.

Attributes

Atributos.

GrantedAccess

Reservado para uso pelo sistema operacional.

HandleCount

Reservado para uso pelo sistema operacional.

PointerCount

Reservado para uso pelo sistema operacional.

PagedPoolCharge

Reservado para uso pelo sistema operacional.

NonPagedPoolCharge

Reservado para uso pelo sistema operacional.

CreationTime

Reservado para uso pelo sistema operacional.

TypeNameLength

O comprimento de TypeName, em bytes.

TypeName

O nome do tipo do objeto referenciado por esse identificador. O buffer não pode ser encerrado por um caractere NULL . O ponteiro é válido durante o tempo de vida do marcador de caminhada passado para PssWalkSnapshot.

ObjectNameLength

O comprimento de ObjectName, em bytes.

ObjectName

Especifica o nome do objeto referenciado por esse identificador. O buffer não pode ser encerrado por um caractere NULL . O ponteiro é válido durante o tempo de vida do marcador de caminhada passado para PssWalkSnapshot.

TypeSpecificInformation

Informações específicas do tipo.

Processar

Válido para PSS_OBJECT_TYPE_PROCESS ObjectType = .

ExitStatus

O código de saída do processo. Se o processo não tiver sido encerrado, isso será definido como STILL_ACTIVE (259).

PebBaseAddress

O endereço do PEB (bloco de ambiente de processo). Reservado para uso pelo sistema operacional.

AffinityMask

A máscara de afinidade do processo.

Basepriority

O nível de prioridade base do processo.

ProcessId

A ID do processo.

ParentProcessId

A ID do processo pai.

Flags

Sinalizadores sobre o processo. Para obter mais informações, consulte PSS_PROCESS_FLAGS.

Thread

Válido para PSS_OBJECT_TYPE_THREAD ObjectType = .

ExitStatus

O código de saída do processo. Se o processo não tiver sido encerrado, isso será definido como STILL_ACTIVE (259).

TebBaseAddress

O endereço do bloco de ambiente de thread (TEB). Reservado para uso pelo sistema operacional.

ProcessId

A ID do processo.

ThreadId

A ID do thread.

AffinityMask

A máscara de afinidade do processo.

Prioridade

O nível de prioridade dinâmica do thread.

Basepriority

O nível de prioridade base do thread.

Win32StartAddress

Um ponteiro para o procedimento de thread para o thread.

Mutante

Válido para PSS_OBJECT_TYPE_MUTANT ObjectType = .

Currentcount

Reservado para uso pelo sistema operacional.

Abandoned

TRUE se o mutante tiver sido abandonado (o thread proprietário saiu sem liberar o mutex), FALSE se não for.

OwnerProcessId

A ID do processo do thread proprietário, no momento da criação instantâneo e da captura do identificador.

OwnerThreadId

A ID do processo do thread proprietário, no momento da criação instantâneo e da captura do identificador.

Evento

Válido para PSS_OBJECT_TYPE_EVENT ObjectType = .

ManualReset

TRUE se o evento for redefinido manualmente, FALSE se não for.

Sinalizado

TRUE se o evento tiver sido sinalizado no momento da criação de instantâneo e manipular a captura, FALSE se não for.

Seção

Válido para PSS_OBJECT_TYPE_SECTION ObjectType = .

BaseAddress

Reservado para uso pelo sistema operacional.

AllocationAttributes

Reservado para uso pelo sistema operacional.

Maximumsize

Reservado para uso pelo sistema operacional.

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

Comentários

PssWalkSnapshot retorna uma estrutura PSS_HANDLE_ENTRY quando o membro PSS_WALK_INFORMATION_CLASS que o chamador fornece é PSS_WALK_HANDLES.

Requisitos

Confira também

Processamento de instantâneos