OpenDesktopA-Funktion (winuser.h)

Artikel
11/20/2024

Öffnet das angegebene Desktopobjekt.

Syntax

HDESK OpenDesktopA(
  [in] LPCSTR      lpszDesktop,
  [in] DWORD       dwFlags,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Parameter

[in] lpszDesktop

Der Name des zu öffnenden Desktops. Bei Desktopnamen wird die Groß-/Kleinschreibung nicht beachtet.

Dieser Desktop muss zur aktuellen Fensterstation gehören.

[in] dwFlags

Dieser Parameter kann null oder der folgende Wert sein.

Wert	Bedeutung
DF_ALLOWOTHERACCOUNTHOOK 0x0001	Ermöglicht Prozessen, die in anderen Konten auf dem Desktop ausgeführt werden, Hooks in diesem Prozess festzulegen.

[in] fInherit

Wenn dieser Wert TRUEist, erben Prozesse, die von diesem Prozess erstellt werden, das Handle. Andernfalls erben die Prozesse diesen Handle nicht.

[in] dwDesiredAccess

Der Zugriff auf den Desktop. Eine Liste der Zugriffsrechte finden Sie unter Desktop security and access rights.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den geöffneten Desktop. Wenn Sie mit der Verwendung des Handle fertig sind, rufen Sie die CloseDesktop--Funktion auf, um sie zu schließen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Der aufrufende Prozess muss über eine zugeordnete Fensterstation verfügen, entweder zur Prozesserstellungszeit vom System zugewiesen oder von der SetProcessWindowStation-Funktion festgelegt.

Wenn der parameter dwDesiredAccess den READ_CONTROL, WRITE_DACoder WRITE_OWNER Standardzugriffsrechte angibt, müssen Sie auch die DESKTOP_READOBJECTS und DESKTOP_WRITEOBJECTS Zugriffsrechte anfordern.

Anmerkung

Der winuser.h-Header definiert OpenDesktop als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)