OpenWindowStationA-Funktion (winuser.h)
Öffnet die angegebene Fensterstation.
Syntax
HWINSTA OpenWindowStationA(
[in] LPCSTR lpszWinSta,
[in] BOOL fInherit,
[in] ACCESS_MASK dwDesiredAccess
);
Parameter
[in] lpszWinSta
Der Name der zu öffnenden Fensterstation. Bei Fensterstationsnamen wird die Groß-/Kleinschreibung nicht beachtet.
Diese Fensterstation muss zur aktuellen Sitzung gehören.
[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 Zugang zur Fensterstation. Eine Liste der Zugriffsrechte finden Sie unter Window Station Security and Access Rights.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Handle für die angegebene Fensterstation.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Nachdem Sie mit dem Handle fertig sind, müssen Sie CloseWindowStation- aufrufen, um den Handle frei zu geben.
Anmerkung
Der winuser.h-Header definiert OpenWindowStation 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) |