Função SetThreadDesktop (winuser.h)

Artigo
03/13/2024

Atribui a área de trabalho especificada ao thread de chamada. Todas as operações subsequentes na área de trabalho usam os direitos de acesso concedidos à área de trabalho.

Sintaxe

BOOL SetThreadDesktop(
  [in] HDESK hDesktop
);

Parâmetros

[in] hDesktop

Um identificador para a área de trabalho a ser atribuído ao thread de chamada. Esse identificador é retornado pela função CreateDesktop, GetThreadDesktop, OpenDesktop ou OpenInputDesktop .

Essa área de trabalho deve ser associada à estação de janela atual para o processo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

A função SetThreadDesktop falhará se o thread de chamada tiver janelas ou ganchos em sua área de trabalho atual (a menos que o parâmetro hDesktop seja um identificador para a área de trabalho atual).

Aviso Há um risco de segurança significativo para qualquer serviço que abra uma janela na área de trabalho interativa. Ao abrir uma janela da área de trabalho, um serviço torna-se vulnerável a ataques do usuário conectado, cujo aplicativo pode enviar mensagens mal-intencionadas para a janela da área de trabalho do serviço e afetar sua capacidade de funcionar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-windowstation-l1-1-0 (introduzido no Windows 8)