Función GetExitCodeProcess (processthreadsapi.h)

Artículo
03/13/2024

Recupera el estado de finalización del proceso especificado.

Sintaxis

BOOL GetExitCodeProcess(
  [in]  HANDLE  hProcess,
  [out] LPDWORD lpExitCode
);

Parámetros

[in] hProcess

Identificador del proceso.

El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION . Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION.

[out] lpExitCode

Puntero a una variable para recibir el estado de finalización del proceso. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función devuelve inmediatamente. Si el proceso no ha finalizado y la función se realiza correctamente, el estado devuelto es STILL_ACTIVE (una macro para STATUS_PENDING (minwinbase.h)). Si el proceso ha finalizado y la función se realiza correctamente, el estado devuelto es uno de los siguientes valores:

Valor de salida especificado en la función ExitProcess o TerminateProcess .
Valor devuelto de la función main o WinMain del proceso.
Valor de excepción de una excepción no controlada que provocó que el proceso finalizara.

Importante

La función GetExitCodeProcess devuelve un código de error válido definido por la aplicación solo después de que finalice el subproceso. Por lo tanto, una aplicación no debe usar STILL_ACTIVE (259) como código de error (STILL_ACTIVE es una macro para STATUS_PENDING (minwinbase.h)). Si un subproceso devuelve STILL_ACTIVE (259) como código de error, las aplicaciones que prueban ese valor podrían interpretarla para indicar que el subproceso todavía está en ejecución y seguir probando la finalización del subproceso una vez finalizado el subproceso, lo que podría poner la aplicación en un bucle infinito.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll