Función OpenProcess (processthreadsapi.h)

Artículo
03/01/2024

Abre un objeto de proceso local existente.

Sintaxis

HANDLE OpenProcess(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwProcessId
);

Parámetros

[in] dwDesiredAccess

Acceso al objeto process. Este derecho de acceso se comprueba con el descriptor de seguridad del proceso. Este parámetro puede ser uno o varios de los derechos de acceso al proceso.

Si el autor de la llamada ha habilitado el privilegio SeDebugPrivilege, se concede el acceso solicitado independientemente del contenido del descriptor de seguridad.

[in] bInheritHandle

Si este valor es TRUE, los procesos creados por este proceso heredarán el identificador. De lo contrario, los procesos no heredan este identificador.

[in] dwProcessId

Identificador del proceso local que se va a abrir.

Si el proceso especificado es el proceso inactivo del sistema (0x00000000), se produce un error en la función y el último código de error es ERROR_INVALID_PARAMETER. Si el proceso especificado es el proceso del sistema o uno de los procesos del Subsistema de Run-Time cliente (CSRSS), esta función produce un error y el último código de error se debe ERROR_ACCESS_DENIED a que sus restricciones de acceso impiden que el código de nivel de usuario los abra.

Si usa GetCurrentProcessId como argumento para esta función, considere la posibilidad de usar GetCurrentProcess en lugar de OpenProcess para mejorar el rendimiento.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador abierto para el proceso especificado.

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

Comentarios

Para abrir un identificador en otro proceso local y obtener derechos de acceso completo, debe habilitar el privilegio SeDebugPrivilege. Para obtener más información, consulte Cambio de privilegios en un token.

El identificador devuelto por la función OpenProcess se puede usar en cualquier función que requiera un identificador para un proceso, como las funciones de espera, siempre que se solicitaron los derechos de acceso adecuados.

Cuando haya terminado con el identificador, asegúrese de cerrarlo mediante la función CloseHandle .

Ejemplos

Para obtener un ejemplo, vea Tomar una instantánea y ver procesos.

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