PSS_HANDLE_ENTRY struttura (processsnapshot.h)
Contiene informazioni su un handle restituito da PssWalkSnapshot.
Sintassi
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;
Members
Handle
Valore handle.
Flags
Flag che indicano quali parti di questa struttura sono valide. Per altre informazioni, vedere PSS_HANDLE_FLAGS.
ObjectType
Tipo dell'oggetto a cui fa riferimento l'handle. Per altre informazioni, vedere PSS_OBJECT_TYPE.
CaptureTime
Tempo di acquisizione di queste informazioni. Per altre informazioni, vedere FILETIME.
Attributes
Attributi.
GrantedAccess
Riservato per l'uso dal sistema operativo.
HandleCount
Riservato per l'uso dal sistema operativo.
PointerCount
Riservato per l'uso dal sistema operativo.
PagedPoolCharge
Riservato per l'uso dal sistema operativo.
NonPagedPoolCharge
Riservato per l'uso dal sistema operativo.
CreationTime
Riservato per l'uso dal sistema operativo.
TypeNameLength
Lunghezza di TypeName, in byte.
TypeName
Nome del tipo dell'oggetto a cui fa riferimento questo handle. Il buffer potrebbe non essere terminato da un carattere NULL . Il puntatore è valido per la durata del marcatore a piedi passato a PssWalkSnapshot.
ObjectNameLength
Lunghezza di ObjectName, in byte.
ObjectName
Specifica il nome dell'oggetto a cui fa riferimento questo handle. Il buffer potrebbe non essere terminato da un carattere NULL . Il puntatore è valido per la durata del marcatore a piedi passato a PssWalkSnapshot.
TypeSpecificInformation
Informazioni specifiche del tipo.
Processo
Valido per ObjectType = PSS_OBJECT_TYPE_PROCESS.
ExitStatus
Codice di uscita del processo. Se il processo non è stato chiuso, questo è impostato su STILL_ACTIVE (259).
PebBaseAddress
Indirizzo del blocco di ambiente del processo (PEB). Riservato per l'uso dal sistema operativo.
AffinityMask
Maschera di affinità del processo.
BasePriority
Livello di priorità di base del processo.
ProcessId
ID del processo.
ParentProcessId
ID processo padre.
Flags
Flag relativi al processo. Per altre informazioni, vedere PSS_PROCESS_FLAGS.
Thread
Valido per ObjectType = PSS_OBJECT_TYPE_THREAD.
ExitStatus
Codice di uscita del processo. Se il processo non è stato chiuso, questo è impostato su STILL_ACTIVE (259).
TebBaseAddress
Indirizzo del blocco di ambiente thread (TEB). Riservato per l'uso dal sistema operativo.
ProcessId
ID del processo.
ThreadId
ID thread.
AffinityMask
Maschera di affinità del processo.
Priorità
Livello di priorità dinamica del thread.
BasePriority
Livello di priorità di base del thread.
Win32StartAddress
Puntatore alla procedura di thread per il thread.
Mutante
Valido per ObjectType = PSS_OBJECT_TYPE_MUTANT.
CurrentCount
Riservato per l'uso dal sistema operativo.
Abbandonato
TRUE se il mutante è stato abbandonato (il filo proprietario è uscito senza rilasciare il mutex), FALSE se non.
OwnerProcessId
ID processo del thread proprietario, al momento della creazione dello snapshot e dell'acquisizione.
OwnerThreadId
ID processo del thread proprietario, al momento della creazione dello snapshot e dell'acquisizione.
Evento
Valido per ObjectType = PSS_OBJECT_TYPE_EVENT.
ManualReset
TRUE se l'evento è reimpostato manualmente, FALSE se non.
Segnalato
TRUE se l'evento è stato segnalato al momento della creazione dello snapshot e dell'acquisizione dell'handle, FALSE se non.
Sezione
Valido per ObjectType = PSS_OBJECT_TYPE_SECTION.
BaseAddress
Riservato per l'uso dal sistema operativo.
AllocationAttributes
Riservato per l'uso dal sistema operativo.
MaximumSize
Riservato per l'uso dal 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
Commenti
PssWalkSnapshot restituisce una struttura PSS_HANDLE_ENTRY quando il membro PSS_WALK_INFORMATION_CLASS fornito dal chiamante è PSS_WALK_HANDLES.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 R2 [solo app desktop] |
| Intestazione | processsnapshot.h |