WlxWkstaLockedSAS, fonction (winwlx.h)

Article
03/04/2024

La fonction WlxWkstaLockedSAS doit être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction lorsqu’elle reçoit une séquence d’attention sécurisée (SAP) et que la station de travail est verrouillée. Le GINA doit retourner une valeur qui indique que la station de travail doit rester verrouillée, que la station de travail doit être déverrouillée ou que l’utilisateur connecté doit être déconnecté (ce qui laisse la station de travail verrouillée jusqu’à ce que la fermeture de session soit terminée).

Note Les DLL GINA sont ignorées dans Windows Vista.

Syntaxe

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

Paramètres

[in] pWlxContext

Pointeur vers le contexte GINA associé à cette station de fenêtre. Le GINA retourne cette valeur de contexte lorsque Winlogon appelle WlxInitialize pour cette station.

[in] dwSasType

Spécifie le type de sap qui s’est produit. Les valeurs comprises entre zéro et WLX_SAS_TYPE_MAX_MSFT_VALUE sont réservées aux types Microsoft SAS standard. Les développeurs GINA peuvent utiliser des valeurs supérieures à WLX_SAS_TYPE_MAX_MSFT_VALUE pour définir des types SAS supplémentaires.

Les types SAS suivants sont prédéfinis.

Valeur	Signification
WLX_SAS_TYPE_CTRL_ALT_DEL	Indique qu’un utilisateur a tapé la séquence d’attention sécurisée (SAS) standard CTRL+ALT+SUPPR.
WLX_SAS_TYPE_SC_INSERT	Indique qu’un carte intelligent a été inséré dans un appareil compatible.
WLX_SAS_TYPE_SC_REMOVE	Indique qu’un carte intelligent a été supprimé d’un appareil compatible.
WLX_SAS_TYPE_TIMEOUT	Indique qu’aucune entrée utilisateur n’a été reçue dans le délai d’attente spécifié.

Valeur retournée

La fonction WlxWkstaLockedSAS doit retourner les valeurs suivantes.

Code de retour	Description
WLX_SAS_ACTION_NONE	Indique à Winlogon de garder la station de travail verrouillée.
WLX_SAS_ACTION_FORCE_LOGOFF	Indique à Winlogon de forcer la déconnexion de l’utilisateur.
WLX_SAS_ACTION_LOGOFF	Indique à Winlogon de déconnecter l’utilisateur actuel.
WLX_SAS_ACTION_UNLOCK_WKSTA	Indique à Winlogon de déverrouiller la station de travail.

Remarques

Avant d’appeler WlxWkstaLockedSAS, Winlogon définit l’état du bureau afin que le bureau actuel soit le bureau Winlogon et définit l’état de la station de travail afin que le bureau soit verrouillé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winwlx.h

Voir aussi

WlxInitialize

Partager via