GetThreadDesktop-Funktion (winuser.h)

Artikel
03/04/2024

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)