estructura PROCESS_INFORMATION (processthreadsapi.h)

Contiene información sobre un proceso recién creado y su subproceso principal. Se usa con la función CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW o CreateProcessWithTokenW .

Sintaxis

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

Miembros

hProcess

Identificador del proceso recién creado. El identificador se usa para especificar el proceso en todas las funciones que realizan operaciones en el objeto de proceso.

hThread

Identificador del subproceso principal del proceso recién creado. El identificador se usa para especificar el subproceso en todas las funciones que realizan operaciones en el objeto de subproceso.

dwProcessId

Valor que se puede usar para identificar un proceso. El valor es válido desde el momento en que se crea el proceso hasta que se cierran todos los identificadores del proceso y se libera el objeto de proceso; en este momento, se puede reutilizar el identificador.

dwThreadId

Valor que se puede usar para identificar un subproceso. El valor es válido desde el momento en que se crea el subproceso hasta que se cierran todos los identificadores del subproceso y se libera el objeto de subproceso; en este momento, se puede reutilizar el identificador.

Comentarios

Si la función se realiza correctamente, asegúrese de llamar a la función CloseHandle para cerrar los identificadores hProcess y hThread cuando haya terminado con ellos. De lo contrario, cuando se cierra el proceso secundario, el sistema no puede limpiar las estructuras de proceso del proceso secundario porque el proceso primario todavía tiene identificadores abiertos para el proceso secundario. Sin embargo, el sistema cerrará estos identificadores cuando finalice el proceso primario, por lo que las estructuras relacionadas con el objeto de proceso secundario se limpiarían en este momento.

Ejemplos

Para obtener un ejemplo, vea Creating Processes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado processthreadsapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)

Consulte también

CreateProcess

CreateProcessAsUser

CreateProcessWithLogonW

CreateProcessWithTokenW