Função GetThreadDesktop (winuser.h)
Recupera um identificador para a área de trabalho atribuída ao thread especificado.
Sintaxe
HDESK GetThreadDesktop(
[in] DWORD dwThreadId
);
Parâmetros
[in] dwThreadId
O identificador de thread. As funções GetCurrentThreadId e CreateProcess retornam identificadores de thread.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para a área de trabalho associada ao thread especificado. Você não precisa chamar a função CloseDesktop para fechar o identificador retornado.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O sistema associa uma área de trabalho a um thread quando esse thread é criado. Um thread pode usar a função SetThreadDesktop para alterar sua área de trabalho. A área de trabalho associada a um thread deve estar na estação de janela associada ao processo do thread.
O processo de chamada pode usar o identificador retornado em chamadas para as funções GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation e SetUserObjectSecurity .
Um aplicativo de serviço é criado com uma estação de janela e área de trabalho associadas, portanto, não é necessário chamar uma função USER ou GDI para conectar o serviço a uma estação de janela e área de trabalho.
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) |