Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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).
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) |