Condividi tramite

enumerazione PSS_CAPTURE_FLAGS (processsnapshot.h)

  • Articolo

Flag che specificano le acquisizioni di PssCaptureSnapshot .

Sintassi

typedef enum {
  PSS_CAPTURE_NONE = 0x00000000,
  PSS_CAPTURE_VA_CLONE = 0x00000001,
  PSS_CAPTURE_RESERVED_00000002 = 0x00000002,
  PSS_CAPTURE_HANDLES = 0x00000004,
  PSS_CAPTURE_HANDLE_NAME_INFORMATION = 0x00000008,
  PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 0x00000010,
  PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 0x00000020,
  PSS_CAPTURE_HANDLE_TRACE = 0x00000040,
  PSS_CAPTURE_THREADS = 0x00000080,
  PSS_CAPTURE_THREAD_CONTEXT = 0x00000100,
  PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 0x00000200,
  PSS_CAPTURE_RESERVED_00000400 = 0x00000400,
  PSS_CAPTURE_VA_SPACE = 0x00000800,
  PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 0x00001000,
  PSS_CAPTURE_IPT_TRACE = 0x00002000,
  PSS_CAPTURE_RESERVED_00004000,
  PSS_CREATE_BREAKAWAY_OPTIONAL = 0x04000000,
  PSS_CREATE_BREAKAWAY = 0x08000000,
  PSS_CREATE_FORCE_BREAKAWAY = 0x10000000,
  PSS_CREATE_USE_VM_ALLOCATIONS = 0x20000000,
  PSS_CREATE_MEASURE_PERFORMANCE = 0x40000000,
  PSS_CREATE_RELEASE_SECTION = 0x80000000
} PSS_CAPTURE_FLAGS;

Costanti

 
PSS_CAPTURE_NONE
Valore: 0x00000000
Acquisire nulla.
PSS_CAPTURE_VA_CLONE
Valore: 0x00000001
Acquisire uno snapshot di tutte le pagine clonabili nel processo. Il clone include tutte le aree MEM_PRIVATE , nonché tutte le sezioni (MEM_MAPPED e MEM_IMAGE) condivisibili. Tutte le sezioni Win32 create tramite CreateFileMapping sono condivisibili.
PSS_CAPTURE_RESERVED_00000002
Valore: 0x00000002
(Non usare).)
PSS_CAPTURE_HANDLES
Valore: 0x00000004
Acquisire la tabella handle (solo gestire i valori).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
Valore: 0x00000008
Acquisire le informazioni sul nome per ogni handle.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
Valore: 0x00000010
Acquisire informazioni di base sull'handle, ad esempio HandleCount, PointerCount, GrantedAccess e così via.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
Valore: 0x00000020
Acquisire informazioni specifiche del tipo per i tipi di oggetti supportati: Processo, Thread, Evento, Mutante, Sezione.
PSS_CAPTURE_HANDLE_TRACE
Valore: 0x00000040
Acquisire la tabella di traccia handle.
PSS_CAPTURE_THREADS
Valore: 0x00000080
Acquisire le informazioni sui thread (solo ID).
PSS_CAPTURE_THREAD_CONTEXT
Valore: 0x00000100
Acquisire il contesto per ogni thread.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
Valore: 0x00000200
Acquisire un contesto esteso per ogni thread, ad esempio CONTEXT_XSTATE.
PSS_CAPTURE_RESERVED_00000400
Valore: 0x00000400
(Non usare).)
PSS_CAPTURE_VA_SPACE
Valore: 0x00000800
Acquisire uno snapshot dello spazio indirizzi virtuale. Lo spazio VA viene acquisito come matrice di strutture MEMORY_BASIC_INFORMATION . Questo flag non acquisisce il contenuto delle pagine.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
Valore: 0x00001000
Per MEM_IMAGE e aree MEM_MAPPED , esegue il dump del percorso del file che esegue il backup delle sezioni (identico a quello restituito da GetMappedFileName ). Per le aree MEM_IMAGE , anche i dump:



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



Il diritto di accesso PROCESS_VM_READ è necessario nell'handle del processo.

Avviso Questa opzione è valida solo quando viene specificata PSS_CAPTURE_VA_SPACE .

 
PSS_CAPTURE_IPT_TRACE
Valore: 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
Valore: 0x04000000
Il breakaway è facoltativo. Se il processo clone non riesce a creare come interruzione, viene creato ancora all'interno del processo. Questo flag deve essere specificato in combinazione con PSS_CREATE_FORCE_BREAKAWAY e/o PSS_CREATE_BREAKAWAY.
PSS_CREATE_BREAKAWAY
Valore: 0x08000000
Il clone viene interrotto dal processo padre. Equivale al flag CreateProcessCREATE_BREAKAWAY_FROM_JOB.
PSS_CREATE_FORCE_BREAKAWAY
Valore: 0x10000000
Il clone viene interrotto forzatamente dal processo padre. Questa opzione è consentita solo per i chiamanti con privilegi Tcb.
PSS_CREATE_USE_VM_ALLOCATIONS
Valore: 0x20000000
La struttura non deve usare l'heap del processo per le allocazioni persistenti o temporanee. L'uso dell'heap può essere indesiderato in determinati contesti, ad esempio la creazione di snapshot nel percorso di creazione di report eccezioni (in cui l'heap potrebbe essere danneggiato).
PSS_CREATE_MEASURE_PERFORMANCE
Valore: 0x40000000
Misurare le prestazioni della struttura. I contatori delle prestazioni possono essere recuperati tramite PssQuerySnapshot con la classe di informazioni PSS_QUERY_PERFORMANCE_COUNTERS di PSS_QUERY_INFORMATION_CLASS.
PSS_CREATE_RELEASE_SECTION
Valore: 0x80000000
Il processo di clonazione dell'indirizzo virtuale (VA) non contiene un riferimento all'immagine sottostante. In questo modo le funzioni, ad esempio QueryFullProcessImageName , non riescono nel processo di clonazione VA.

Importante  

Questo flag non ha alcun effetto a meno che non sia specificato PSS_CAPTURE_VA_CLONE .


 

Commenti

Se vengono specificati sia PSS_CREATE_FORCE_BREAKAWAY che PSS_CREATE_BREAKAWAY , PSS_CREATE_FORCE_BREAKAWAY ha la precedenza.

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

Vedi anche

Snapshot dei processi