Función OpenThread (processthreadsapi.h)

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

Vea también

CloseHandle

GetExitCodeThread

GetThreadContext

Funciones de proceso y subproceso

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Subprocesos