Freigeben über


CloseDesktop-Funktion (winuser.h)

Schließt ein geöffnetes Handle für ein Desktopobjekt.

Syntax

BOOL CloseDesktop(
  [in] HDESK hDesktop
);

Parameter

[in] hDesktop

Ein Handle für den zu schließenden Desktop. Dies kann ein Handle sein, das von den Funktionen CreateDesktop, OpenDesktop oder OpenInputDesktop zurückgegeben wird. Geben Sie nicht das von der GetThreadDesktop-Funktion zurückgegebene Handle an.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die CloseDesktop-Funktion schlägt fehl, wenn ein Thread im aufrufenden Prozess das angegebene Desktophandle verwendet oder das Handle auf den ersten Desktop des aufrufenden Prozesses verweist.

Anforderungen

   
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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-windowstation-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

CreateDesktop

Desktops

OpenDesktop

OpenInputDesktop

Window Station- und Desktopfunktionen