_WinAPI_CreateWindowStation
Beschreibung anzeigen in
Erzeugt ein Fensterstationsobjekt assoziiert mit dem aufrufenden Prozess und weißt sie der aktuellen Sitzung zu.
#include <WinAPISys.au3>
_WinAPI_CreateWindowStation ( [$sName = '' [, $iAccess = 0 [, $iFlags = 0 [, $tSecurity = 0]]]] )
Parameter
| $sName | [optional] Der Name der zu erstellenden Fensterstation. Fensterstationsnamen beachten keine Groß-/ Kleinschreibung und dürfen keine Backslash (\) Zeichen beinhalten. Nur Mitglieder der Administratorengruppe sind befugt einen Namen anzugeben. Wenn dieser Parameter ein leerer String ist (Standard), so wählt das System einen Fensterstationsnamen aus mittels des Anmeldesitzungsidentifizierers des aufrufenden Prozesses. |
| $iAccess | [optional] Der Typ des Zugriffs welche das zurückgegebene Handle zur Fensterstation hat. Dieser Parameter kann einen oder mehrere der folgenden Werte annehmen: $WINSTA_ALL_ACCESS $WINSTA_ACCESSCLIPBOARD $WINSTA_ACCESSGLOBALATOMS $WINSTA_CREATEDESKTOP $WINSTA_ENUMDESKTOPS $WINSTA_ENUMERATE $WINSTA_EXITWINDOWS $WINSTA_READATTRIBUTES $WINSTA_READSCREEN $WINSTA_WRITEATTRIBUTES |
| $iFlags | [optional] Die optionalen Flags. Dieser kann 0 sein (Standard) oder der folgende Wert: $CWF_CREATE_ONLY |
| $tSecurity | [optional] Die $tagSECURITY_ATTRIBUTES Struktur welche angibt ob das zurückgegebene Handle von Childprozessen geerbt werden kann. Wenn dieser Parameter 0 ist (Standard), so kann das Handle nicht geerbt werden. |
Rückgabewert
| Erfolg: | Das Handle der neu erzeugten Fensterstation. Wenn die abgegebene Fensterstation bereits existiert, so gelingt die Funktion und es wird das Handle zu der bereits existierenden Fensterstation zurückgegeben.. |
| Fehler: | 0. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlerinformationen zu erhalten. |
Bemerkungen
Wenn die Arbeit mit dem Handle abgeschlossen ist, muss es mit der _WinAPI_CloseWindowStation() Funktion freigegeben werden.
Verwandte Funktionen
Siehe auch
Suche nach CreateWindowStation in der MSDN Bibliothek.