GetThreadDesktop-Funktion (winuser.h)
Ruft ein Handle für den Desktop ab, der dem angegebenen Thread zugewiesen ist.
Syntax
HDESK GetThreadDesktop(
[in] DWORD dwThreadId
);
Parameter
[in] dwThreadId
Der Threadbezeichner. Die Funktionen GetCurrentThreadId und CreateProcess geben Threadbezeichner zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Desktop, der dem angegebenen Thread zugeordnet ist. Sie müssen die CloseDesktop-Funktion nicht aufrufen, um das zurückgegebene Handle zu schließen.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Das System ordnet einen Desktop einem Thread zu, wenn dieser Thread erstellt wird. Ein Thread kann die SetThreadDesktop-Funktion verwenden, um seinen Desktop zu ändern. Der einem Thread zugeordnete Desktop muss sich auf der Fensterstation befinden, die dem Prozess des Threads zugeordnet ist.
Der aufrufende Prozess kann das zurückgegebene Handle in Aufrufen der Funktionen GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation und SetUserObjectSecurity verwenden.
Eine Dienstanwendung wird mit einer zugeordneten Fensterstation und einem zugeordneten Desktop erstellt, sodass keine USER- oder GDI-Funktion aufgerufen werden muss, um den Dienst mit einer Fensterstation und einem Desktop zu verbinden.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winuser.h (einschließlich Windows.h) |
Bibliothek | User32.lib |
DLL | User32.dll |
APIs | ext-ms-win-ntuser-windowstation-l1-1-0 (eingeführt in Windows 8) |