Compartilhar via


Função OpenThread (processthreadsapi.h)

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

Confira também

CloseHandle

GetExitCodeThread

GetThreadContext

Funções de thread e processo

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Threads