Función OpenThread (processthreadsapi.h)

Artículo
08/25/2023

Abre un objeto de subproceso existente.

Sintaxis

HANDLE OpenThread(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwThreadId
);

Parámetros

[in] dwDesiredAccess

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

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] dwThreadId

Identificador del subproceso que se va a abrir.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador abierto para el subproceso 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

El identificador devuelto por OpenThread se puede usar en cualquier función que requiera un identificador para un subproceso, como las funciones de espera, siempre que haya solicitado los derechos de acceso adecuados. Al identificador solo se le concede acceso al objeto de subproceso en la medida en que se especificó en el parámetro dwDesiredAccess .

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

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