WlxLoggedOnSAS-Funktion (winwlx.h)

  • Artikel

[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.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.
 

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
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
 Gibt an, dass innerhalb des angegebenen Timeoutzeitraums keine Benutzereingabe empfangen wurde.
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
 Gibt an, dass ein Benutzer die standardmäßige SICHERE AUFMERKSAMKEITSSEQUENZ (SAS ) STRG+ALT+DEL eingegeben hat.
WLX_SAS_TYPE_SC_INSERT
5 (0x5)
 Gibt an, dass eine intelligente Karte in ein kompatibles Gerät eingefügt wurde.
WLX_SAS_TYPE_SC_REMOVE
6 (0x6)
 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
WLX_SAS_ACTION_NONE
 Kehrt zum Standarddesktop zurück.
WLX_SAS_ACTION_LOCK_WKSTA
 Sperrt die Arbeitsstation und wartet auf die nächste SAS.
WLX_SAS_ACTION_LOGOFF
 Protokolliert den Benutzer von der Arbeitsstation.
WLX_SAS_ACTION_SHUTDOWN
 Protokolliert den Benutzer aus, und fährt den Computer herunter.
WLX_SAS_ACTION_SHUTDOWN_REBOOT
 Protokolliert den Benutzer ab, fährt den Computer herunter und startet dann den Computer neu.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
 Wenn die Hardware dies zulässt, protokolliert den Benutzer ab, fährt den Computer herunter und schaltet den Computer dann aus.
WLX_SAS_ACTION_PWD_CHANGED
 Benachrichtigt Netzwerkanbieter, dass der Benutzer sein Kennwort geändert hat. Veraltete GINA-DLLs sollten WlxChangePasswordNotify aufrufen, wenn ein Kennwort geändert wird.
WLX_SAS_ACTION_TASKLIST
 Ruft die Aufgabenliste auf.
WLX_SAS_ACTION_FORCE_LOGOFF
 Meldet den Benutzer gewaltsam ab.
WLX_SAS_ACTION_SHUTDOWN_SLEEP
 Versetzt den Computer in den Ruhemodus.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
 Fährt das System in einen ACPI-Herunterschaltzustand herunter. Wenn der Computer kein ACPI-Computer ist, hat diese Option keine Auswirkung.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
 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

Weitere Informationen

WlxInitialize

WlxWkstaLockedSAS