Função GetCurrentThread (processthreadsapi.h)

Artigo
03/13/2024

Recupera um pseudo-identificador para o thread de chamada.

Sintaxe

HANDLE GetCurrentThread();

Retornar valor

O valor retornado é um pseudo-identificador para o thread atual.

Comentários

Um pseudo-identificador é uma constante especial que é interpretada como o identificador de thread atual. O thread de chamada pode usar esse identificador para se especificar sempre que um identificador de thread for necessário. Pseudo-identificadores não são herdados por processos filho.

Esse identificador tem o acesso THREAD_ALL_ACCESS diretamente ao objeto de thread. Para obter mais informações, consulte Segurança de thread e direitos de acesso.

Windows Server 2003 e Windows XP: Esse identificador tem o acesso máximo permitido pelo descritor de segurança do thread para o token primário do processo.

A função não pode ser usada por um thread para criar um identificador que pode ser usado por outros threads para se referir ao primeiro thread. O identificador sempre é interpretado como se referindo ao thread que o está usando. Um thread pode criar um identificador "real" para si mesmo que pode ser usado por outros threads ou herdado por outros processos, especificando o pseudo-identificador como o identificador de origem em uma chamada para a função DuplicateHandle .

O pseudo-identificador não precisa ser fechado quando não é mais necessário. Chamar a função CloseHandle com esse identificador não tem efeito. Se o pseudo-identificador for duplicado por DuplicateHandle, o identificador duplicado deverá ser fechado.

Não crie um thread ao representar um contexto de segurança. A chamada terá êxito, no entanto, o thread recém-criado terá direitos de acesso reduzidos a si mesmo ao chamar GetCurrentThread. Os direitos de acesso concedidos a esse thread serão derivados dos direitos de acesso que o usuário representado tem ao processo. Alguns direitos de acesso, incluindo THREAD_SET_THREAD_TOKEN e THREAD_GET_CONTEXT , podem não estar presentes, levando a falhas inesperadas.

Exemplos

Para obter um exemplo, consulte Verificando o acesso do cliente.

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