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

類型特定資訊。

流程

適用於 ObjectType = PSS_OBJECT_TYPE_PROCESS。

ExitStatus

進程的結束代碼。 如果進程尚未結束，這會設定為 STILL_ACTIVE ( 259) 。

PebBaseAddress

進程環境區塊的位址 (PEB) 。 保留供操作系統使用。

AffinityMask

進程的親和性遮罩。

BasePriority

進程的基底優先順序層級。

ProcessId

處理序識別碼。

ParentProcessId

父進程標識碼。

Flags

關於進程的旗標。 如需詳細資訊，請參閱 PSS_PROCESS_FLAGS。

執行緒

適用於 ObjectType = PSS_OBJECT_TYPE_THREAD。

ExitStatus

進程的結束代碼。 如果進程尚未結束，這會設定為 STILL_ACTIVE ( 259) 。

TebBaseAddress

線程環境區塊的位址 (TEB) 。 保留供操作系統使用。

ProcessId

處理序識別碼。

ThreadId

線程標識碼。

AffinityMask

進程的親和性遮罩。

優先順序

線程的動態優先順序層級。

BasePriority

線程的基底優先順序。

Win32StartAddress

線程線程程式的指標。

突變

適用於 ObjectType = PSS_OBJECT_TYPE_MUTANT。

CurrentCount

保留供操作系統使用。

Abandoned

TRUE 是表示 如果已放棄 (擁有線程結束而不釋放 mutex) ，則為 FALSE 。

OwnerProcessId

在建立快照集並處理擷取時，擁有線程的進程標識符。

OwnerThreadId

在建立快照集並處理擷取時，擁有線程的進程標識符。

事件

適用於 ObjectType = PSS_OBJECT_TYPE_EVENT。

ManualReset

如果事件是手動重設，則為TRUE，否則為 FALSE。

暗示

如果 事件在快照集建立時收到訊號並處理擷取，則為TRUE，否則為 FALSE 。

區段

適用於 ObjectType = PSS_OBJECT_TYPE_SECTION。

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_WALK_INFORMATION_CLASS成員PSS_WALK_HANDLES時傳回PSS_HANDLE_ENTRY結構。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
標頭 processsnapshot.h

另請參閱

處理快照集