estructura PSS_HANDLE_ENTRY (processsnapshot.h)

Contiene información sobre un identificador devuelto por PssWalkSnapshot.

Sintaxis

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;

Miembros

Handle

Valor de identificador.

Flags

Marcas que indican qué partes de esta estructura son válidas. Para obtener más información, vea PSS_HANDLE_FLAGS.

ObjectType

Tipo del objeto al que hace referencia el identificador. Para obtener más información, consulte PSS_OBJECT_TYPE.

CaptureTime

El tiempo de captura de esta información. Para obtener más información, vea FILETIME.

Attributes

Atributos.

GrantedAccess

Reservado para su uso por el sistema operativo.

HandleCount

Reservado para su uso por el sistema operativo.

PointerCount

Reservado para su uso por el sistema operativo.

PagedPoolCharge

Reservado para su uso por el sistema operativo.

NonPagedPoolCharge

Reservado para su uso por el sistema operativo.

CreationTime

Reservado para su uso por el sistema operativo.

TypeNameLength

Longitud de TypeName, en bytes.

TypeName

Nombre de tipo del objeto al que hace referencia este identificador. El búfer no puede terminar con un carácter NULL . El puntero es válido durante la vigencia del marcador de recorrido pasado a PssWalkSnapshot.

ObjectNameLength

Longitud de ObjectName, en bytes.

ObjectName

Especifica el nombre del objeto al que hace referencia este identificador. El búfer no puede terminar con un carácter NULL . El puntero es válido durante la vigencia del marcador de recorrido pasado a PssWalkSnapshot.

TypeSpecificInformation

Información específica del tipo.

Proceso

Válido parael PSS_OBJECT_TYPE_PROCESSObjectType = .

ExitStatus

Código de salida del proceso. Si el proceso no se ha cerrado, se establece en STILL_ACTIVE (259).

PebBaseAddress

Dirección del bloque de entorno de proceso (PEB). Reservado para su uso por el sistema operativo.

AffinityMask

Máscara de afinidad del proceso.

BasePriority

Nivel de prioridad base del proceso.

ProcessId

El id. de proceso.

ParentProcessId

Identificador del proceso primario.

Marcas

Marcas sobre el proceso. Para obtener más información, consulte PSS_PROCESS_FLAGS.

Thread

Válido parael PSS_OBJECT_TYPE_THREADObjectType = .

ExitStatus

Código de salida del proceso. Si el proceso no se ha cerrado, se establece en STILL_ACTIVE (259).

TebBaseAddress

Dirección del bloque de entorno de subprocesos (TEB). Reservado para su uso por el sistema operativo.

ProcessId

El id. de proceso.

ThreadId

Identificador del subproceso.

AffinityMask

Máscara de afinidad del proceso.

Priority

Nivel de prioridad dinámica del subproceso.

BasePriority

Nivel de prioridad base del subproceso.

Win32StartAddress

Puntero al procedimiento de subproceso del subproceso.

Mutante

Válido parael PSS_OBJECT_TYPE_MUTANTObjectType = .

CurrentCount

Reservado para su uso por el sistema operativo.

Abandoned

TRUE si el mutante se ha abandonado (el subproceso propietario salió sin liberar la exclusión mutua), FALSE si no.

OwnerProcessId

El identificador de proceso del subproceso propietario, en el momento de la creación de instantáneas y la captura de identificador.

OwnerThreadId

El identificador de proceso del subproceso propietario, en el momento de la creación de instantáneas y la captura de identificador.

Evento

Válido parael PSS_OBJECT_TYPE_EVENTObjectType = .

ManualReset

TRUE si el evento es de restablecimiento manual, FALSE si no es así.

Señalado

TRUE si el evento se ha señalado en el momento de la creación de instantáneas y controla la captura, FALSE si no es así.

Sección

Válido parael PSS_OBJECT_TYPE_SECTIONObjectType = .

BaseAddress

Reservado para su uso por el sistema operativo.

AllocationAttributes

Reservado para su uso por el sistema operativo.

MaximumSize

Reservado para su uso por el sistema operativo.

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

Comentarios

PssWalkSnapshot devuelve una estructura PSS_HANDLE_ENTRY cuando el miembro PSS_WALK_INFORMATION_CLASS que proporciona el autor de la llamada es PSS_WALK_HANDLES.

Requisitos

Consulte también

Procesar instantáneas