Función GetCurrentProcess (processthreadsapi.h)

Artículo
03/01/2024

Recupera un pseudo handle para el proceso actual.

Sintaxis

HANDLE GetCurrentProcess();

Valor devuelto

El valor devuelto es un pseudo handle para el proceso actual.

Comentarios

Un pseudo handle es una constante especial, actualmente (HANDLE)-1, que se interpreta como el identificador de proceso actual. Para la compatibilidad con sistemas operativos futuros, es mejor llamar a GetCurrentProcess en lugar de codificar de forma rígida este valor constante. El proceso de llamada puede usar un pseudoadillador para especificar su propio proceso siempre que se requiera un identificador de proceso. Los procesos secundarios no heredan los pseudo identificadores.

Este identificador tiene el derecho de acceso PROCESS_ALL_ACCESS al objeto de proceso. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

Windows Server 2003 y Windows XP: Este identificador tiene el acceso máximo permitido por el descriptor de seguridad del proceso al token principal del proceso.

Un proceso puede crear un identificador "real" para sí mismo que sea válido en el contexto de otros procesos, o que otros procesos puedan heredar, especificando el pseudo handle como identificador de origen en una llamada a la función DuplicateHandle . Un proceso también puede usar la función OpenProcess para abrir un identificador real a sí mismo.

No es necesario cerrar el pseudoaje cuando ya no es necesario. Llamar a la función CloseHandle con un pseudo handle no tiene ningún efecto. Si duplicated the pseudo handle is duplicated by DuplicateHandle, the duplicate handle must be closed.

Ejemplos

Para obtener un ejemplo, consulte Creación de un proceso secundario con entrada y salida redirigidos.

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 (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll