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 |