WlxWkstaLockedSAS-Funktion (winwlx.h)

Artikel
03/06/2024

Die WlxWkstaLockedSAS-Funktion muss von einer GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion auf, wenn sie eine sichere Aufmerksamkeitssequenz (SAS ) empfängt und die Arbeitsstation gesperrt ist. Die GINA sollte einen Wert zurückgeben, der angibt, dass die Arbeitsstation gesperrt bleiben soll, die Arbeitsstation entsperrt oder der angemeldete Benutzer abgemeldet werden soll (wodurch die Arbeitsstation gesperrt bleibt, bis die Abmeldung abgeschlossen ist).

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

int WlxWkstaLockedSAS(
  [in] PVOID pWlxContext,
  [in] DWORD dwSasType
);

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 für Standardmäßige Microsoft SAS-Typen reserviert. GINA-Entwickler können Werte verwenden, die größer als WLX_SAS_TYPE_MAX_MSFT_VALUE sind, um zusätzliche SAS-Typen zu definieren.

Die folgenden SAS-Typen sind vordefiniert.

Wert	Bedeutung
WLX_SAS_TYPE_CTRL_ALT_DEL	Gibt an, dass ein Benutzer die Standardmäßige SICHERE AUFMERKSAMKEITSSEQUENZ (SAS ) STRG+ALT+DEL eingegeben hat.
WLX_SAS_TYPE_SC_INSERT	Gibt an, dass eine intelligente Karte in ein kompatibles Gerät eingefügt wurde.
WLX_SAS_TYPE_SC_REMOVE	Gibt an, dass eine intelligente Karte von einem kompatiblen Gerät entfernt wurde.
WLX_SAS_TYPE_TIMEOUT	Gibt an, dass innerhalb des angegebenen Timeoutzeitraums keine Benutzereingabe empfangen wurde.

Rückgabewert

Die WlxWkstaLockedSAS-Funktion sollte die folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
WLX_SAS_ACTION_NONE	Weist Winlogon an, die Arbeitsstation gesperrt zu lassen.
WLX_SAS_ACTION_FORCE_LOGOFF	Weist Winlogon an, den Benutzer gewaltsam abzumelden.
WLX_SAS_ACTION_LOGOFF	Weist Winlogon an, den aktuellen Benutzer abzumelden.
WLX_SAS_ACTION_UNLOCK_WKSTA	Weist Winlogon an, die Arbeitsstation zu entsperren.

Hinweise

Vor dem Aufrufen von WlxWkstaLockedSAS 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

Anforderung	Wert
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

Freigeben über