Freigeben über


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)

Weitere Informationen

Desktops

GetCurrentThreadId

GetProcessWindowStation

GetUserObjectInformation

GetUserObjectSecurity

SetProcessWindowStation

SetThreadDesktop

SetUserObjectInformation

SetUserObjectSecurity

Window Station- und Desktopfunktionen