WlxLoggedOnSAS-Funktion (winwlx.h)
[Die WlxLoggedOnSAS-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]
Die WlxLoggedOnSAS-Funktion muss von einer GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion auf, wenn es ein SAS-Ereignis (Secure Attention Sequence ) empfängt, während der Benutzer angemeldet ist und die Arbeitsstation nicht gesperrt ist.
Syntax
int WlxLoggedOnSAS(
[in] PVOID pWlxContext,
[in] DWORD dwSasType,
[in] PVOID pReserved
);
Parameter
[in] pWlxContext
Ein Zeiger auf den GINA-Kontext, der dieser Fensterstation zugeordnet ist. Die GINA gibt diesen Kontextwert zurück, wenn Winlogon WlxInitialize für diese Station aufruft.
[in] dwSasType
Gibt den Sas-Typ an, der aufgetreten ist. Werte von null bis WLX_SAS_TYPE_MAX_MSFT_VALUE sind zum Definieren von Microsoft SAS-Standardtypen reserviert. GINA-Entwickler können zusätzliche SAS-Typen definieren, indem sie Werte verwenden, die größer als WLX_SAS_TYPE_MAX_MSFT_VALUE sind.
Die folgenden SAS-Typen sind vordefiniert.
| Wert | Bedeutung |
|---|---|
|
Gibt an, dass innerhalb des angegebenen Timeoutzeitraums keine Benutzereingabe empfangen wurde. |
|
Gibt an, dass ein Benutzer die standardmäßige SICHERE AUFMERKSAMKEITSSEQUENZ (SAS ) STRG+ALT+DEL eingegeben hat. |
|
Gibt an, dass eine intelligente Karte in ein kompatibles Gerät eingefügt wurde. |
|
Gibt an, dass eine intelligente Karte von einem kompatiblen Gerät entfernt wurde. |
[in] pReserved
Dieser Parameter ist reserviert und muss auf NULL festgelegt werden.
Rückgabewert
Die WlxLoggedOnSAS-Funktion sollte einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Kehrt zum Standarddesktop zurück. |
|
Sperrt die Arbeitsstation und wartet auf die nächste SAS. |
|
Protokolliert den Benutzer von der Arbeitsstation. |
|
Protokolliert den Benutzer aus, und fährt den Computer herunter. |
|
Protokolliert den Benutzer ab, fährt den Computer herunter und startet dann den Computer neu. |
|
Wenn die Hardware dies zulässt, protokolliert den Benutzer ab, fährt den Computer herunter und schaltet den Computer dann aus. |
|
Benachrichtigt Netzwerkanbieter, dass der Benutzer sein Kennwort geändert hat. Veraltete GINA-DLLs sollten WlxChangePasswordNotify aufrufen, wenn ein Kennwort geändert wird. |
|
Ruft die Aufgabenliste auf. |
|
Meldet den Benutzer gewaltsam ab. |
|
Versetzt den Computer in den Ruhemodus. |
|
Fährt das System in einen ACPI-Herunterschaltzustand herunter. Wenn der Computer kein ACPI-Computer ist, hat diese Option keine Auswirkung. |
|
Fährt das System in den Ruhezustand herunter. Wenn das System nicht für den Ruhezustand konfiguriert wurde, hat diese Option keine Auswirkungen. |
Hinweise
Winlogon ruft WlxLoggedOnSAS auf, wenn der angemeldete Benutzer die Arbeitsstation herunterfahren, sich abmelden oder sperren möchte. Die GINA-DLL kann die Arbeitsstation sperren, indem WLX_SAS_ACTION_LOCK_WKSTA zurückgegeben wird. Wenn dieser Wert zurückgegeben wird, sperrt Winlogon die Arbeitsstation und ruft WlxWkstaLockedSAS auf, wenn sie das nächste Mal eine SAS empfängt.
Vor dem Aufrufen von WlxLoggedOnSAS legt Winlogon den Desktopstatus so fest, dass der aktuelle Desktop der Winlogon-Desktop ist, und legt den Arbeitsstationsstatus so fest, dass der Desktop gesperrt ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winwlx.h |