Função OpenThread (processthreadsapi.h)

Artigo
08/25/2023

Abre um objeto de thread existente.

Sintaxe

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

Parâmetros

[in] dwDesiredAccess

O acesso ao objeto de thread. Esse direito de acesso é verificado no descritor de segurança do thread. Esse parâmetro pode ser um ou mais dos direitos de acesso de thread.

Se o chamador tiver habilitado o privilégio SeDebugPrivilege, o acesso solicitado será concedido independentemente do conteúdo do descritor de segurança.

[in] bInheritHandle

Se esse valor for TRUE, os processos criados por esse processo herdarão o identificador. Caso contrário, os processos não herdam esse identificador.

[in] dwThreadId

O identificador do thread a ser aberto.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador aberto para o thread especificado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O identificador retornado pelo OpenThread pode ser usado em qualquer função que exija um identificador para um thread, como as funções de espera, desde que você tenha solicitado os direitos de acesso apropriados. O identificador recebe acesso ao objeto thread apenas na medida em que foi especificado no parâmetro dwDesiredAccess .

Quando terminar de usar o identificador, feche-o usando a função CloseHandle .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll