WlxLoggedOnSAS, fonction (winwlx.h)

Article
08/28/2023

[La fonction WlxLoggedOnSAS n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La fonction WlxLoggedOnSAS doit être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction lorsqu’elle reçoit un événement de séquence d’attention sécurisée (SAS) alors que l’utilisateur est connecté et que la station de travail n’est pas verrouillée.

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

Syntaxe

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

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 pour définir les types SAS Microsoft standard. Les développeurs GINA peuvent définir des types SAS supplémentaires en utilisant des valeurs supérieures à WLX_SAS_TYPE_MAX_MSFT_VALUE.

Les types SAS suivants sont prédéfinis.

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

[in] pReserved

Ce paramètre est réservé et doit être défini sur NULL.

Valeur retournée

La fonction WlxLoggedOnSAS doit retourner l’une des valeurs suivantes.

Code de retour	Description
WLX_SAS_ACTION_NONE	Retourne au bureau par défaut.
WLX_SAS_ACTION_LOCK_WKSTA	Verrouille la station de travail et attend la signature d’accès partagé suivante.
WLX_SAS_ACTION_LOGOFF	Déconnecte l’utilisateur de la station de travail.
WLX_SAS_ACTION_SHUTDOWN	Déconnecte l’utilisateur et arrête l’ordinateur.
WLX_SAS_ACTION_SHUTDOWN_REBOOT	Déconnecte l’utilisateur, arrête l’ordinateur, puis redémarre l’ordinateur.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF	Si le matériel le permet, déconnecte l’utilisateur, arrête l’ordinateur, puis le désactive.
WLX_SAS_ACTION_PWD_CHANGED	Avertit les fournisseurs réseau que l’utilisateur a modifié son mot de passe. Les DLL GINA obsolètes doivent appeler WlxChangePasswordNotify chaque fois qu’un mot de passe est modifié.
WLX_SAS_ACTION_TASKLIST	Appelle la liste des tâches.
WLX_SAS_ACTION_FORCE_LOGOFF	Déconnecte de force l’utilisateur.
WLX_SAS_ACTION_SHUTDOWN_SLEEP	Place l’ordinateur en mode suspension.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2	Arrête le système dans un état de mise hors tension ACPI. Si l’ordinateur n’est pas un ordinateur ACPI, cette option n’aura aucun effet.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE	Arrête le système en mode de mise en veille prolongée. Si le système n’a pas été configuré pour la mise en veille prolongée, cette option n’aura aucun effet.

Remarques

Winlogon appelle WlxLoggedOnSAS lorsque l’utilisateur connecté souhaite arrêter, se déconnecter ou verrouiller la station de travail. La DLL GINA peut verrouiller la station de travail en retournant WLX_SAS_ACTION_LOCK_WKSTA. Lorsque cette valeur est retournée, Winlogon verrouille la station de travail et appelle WlxWkstaLockedSAS la prochaine fois qu’il reçoit une signature d’accès partagé.

Avant d’appeler WlxLoggedOnSAS, 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é.

Spécifications


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

WlxWkstaLockedSAS

Partager via