struttura PROCESS_INFORMATION (processthreadsapi.h)

  • Articolo

Contiene informazioni su un processo appena creato e sul relativo thread primario. Viene usato con la funzione CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW o CreateProcessWithTokenW .

Sintassi

typedef struct _PROCESS_INFORMATION {
  HANDLE hProcess;
  HANDLE hThread;
  DWORD  dwProcessId;
  DWORD  dwThreadId;
} PROCESS_INFORMATION, *PPROCESS_INFORMATION, *LPPROCESS_INFORMATION;

Members

hProcess

Handle per il processo appena creato. L'handle viene usato per specificare il processo in tutte le funzioni che eseguono operazioni sull'oggetto processo.

hThread

Handle per il thread primario del processo appena creato. L'handle viene usato per specificare il thread in tutte le funzioni che eseguono operazioni sull'oggetto thread.

dwProcessId

Valore che può essere utilizzato per identificare un processo. Il valore è valido dal momento in cui il processo viene creato fino a quando tutti gli handle del processo non vengono chiusi e l'oggetto processo viene liberato; a questo punto, l'identificatore può essere riutilizzato.

dwThreadId

Valore che può essere utilizzato per identificare un thread. Il valore è valido dal momento in cui il thread viene creato fino a quando tutti gli handle al thread non vengono chiusi e l'oggetto thread viene liberato; a questo punto, l'identificatore può essere riutilizzato.

Commenti

Se la funzione ha esito positivo, chiamare la funzione CloseHandle per chiudere gli handle hProcess e hThread al termine dell'operazione. In caso contrario, quando il processo figlio viene chiuso, il sistema non può pulire le strutture di processo per il processo figlio perché il processo padre dispone ancora di handle aperti per il processo figlio. Tuttavia, il sistema chiuderà questi handle al termine del processo padre, in modo che le strutture correlate all'oggetto processo figlio vengano pulite a questo punto.

Esempio

Per un esempio, vedere Creazione di processi.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione processthreadsapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)

Vedi anche

CreateProcess

Createprocessasuser

CreateProcessWithLogonW

CreateProcessWithTokenW