Funzione WlxLoggedOnSAS (winwlx.h)

Articolo
03/08/2023

[La funzione WlxLoggedOnSAS non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La funzione WlxLoggedOnSAS deve essere implementata da una DLL GINA sostitutiva. Winlogon chiama questa funzione quando riceve un evento sas (Secure Attention Sequence ) mentre l'utente è connesso e la workstation non è bloccata.

Nota Le DLL GINA vengono ignorate in Windows Vista.

Sintassi

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

Parametri

[in] pWlxContext

Puntatore al contesto GINA associato a questa stazione finestra. La GINA restituisce questo valore di contesto quando Winlogon chiama WlxInitialize per questa stazione.

[in] dwSasType

Specifica il tipo di firma di accesso condiviso che si è verificato. I valori da zero a WLX_SAS_TYPE_MAX_MSFT_VALUE sono riservati per definire tipi di firma di accesso condiviso Microsoft standard. Gli sviluppatori GINA possono definire tipi di firma di accesso condiviso aggiuntivi usando valori maggiori di WLX_SAS_TYPE_MAX_MSFT_VALUE.

I tipi di firma di accesso condiviso seguenti sono predefiniti.

Valore	Significato
WLX_SAS_TYPE_TIMEOUT 0 (0x0)	Indica che non è stato ricevuto alcun input utente entro il periodo di timeout specificato.
WLX_SAS_TYPE_CTRL_ALT_DEL 1 (0x1)	Indica che un utente ha digitato la sequenza di attenzione sicura CTRL+ALT+CANC (SAS).
WLX_SAS_TYPE_SC_INSERT 5 (0x5)	Indica che una smart card è stata inserita in un dispositivo compatibile.
WLX_SAS_TYPE_SC_REMOVE 6 (0x6)	Indica che una smart card è stata rimossa da un dispositivo compatibile.

[in] pReserved

Questo parametro è riservato e deve essere impostato su NULL.

Valore restituito

La funzione WlxLoggedOnSAS deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
WLX_SAS_ACTION_NONE	Restituisce il desktop predefinito.
WLX_SAS_ACTION_LOCK_WKSTA	Blocca la workstation e attende la firma di accesso condiviso successivo.
WLX_SAS_ACTION_LOGOFF	Registra l'utente dalla workstation.
WLX_SAS_ACTION_SHUTDOWN	Registra l'utente e arresta il computer.
WLX_SAS_ACTION_SHUTDOWN_REBOOT	Registra l'utente, arresta il computer e quindi riavvia il computer.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF	Se l'hardware consente, registra l'utente, arresta il computer e quindi disattiva il computer.
WLX_SAS_ACTION_PWD_CHANGED	Notifica ai provider di rete che l'utente ha modificato la password. Le DLL GINA obsolete devono chiamare WlxChangePasswordNotify ogni volta che viene modificata una password.
WLX_SAS_ACTION_TASKLIST	Richiama l'elenco di attività.
WLX_SAS_ACTION_FORCE_LOGOFF	Si disconnette forzatamente l'utente.
WLX_SAS_ACTION_SHUTDOWN_SLEEP	Inserisce il computer in modalità di sospensione.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2	Arresta il sistema in uno stato di alimentazione ACPI. Se il computer non è un computer ACPI, questa opzione non avrà alcun effetto.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE	Arresta il sistema nella modalità di ibernazione. Se il sistema non è stato configurato per l'ibernazione, questa opzione non avrà alcun effetto.

Commenti

Winlogon chiama WlxLoggedOnSAS quando l'utente connesso vuole arrestare, disconnettersi o bloccare la workstation. La DLL GINA può bloccare la workstation restituendo WLX_SAS_ACTION_LOCK_WKSTA. Quando viene restituito questo valore, Winlogon blocca la workstation e chiama WlxWkstaLockedSAS alla successiva ricezione di una firma di accesso condiviso.

Prima di chiamare WlxLoggedOnSAS, Winlogon imposta lo stato del desktop in modo che il desktop corrente sia il desktop Winlogon e imposti lo stato della workstation in modo che il desktop sia bloccato.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winwlx.h

Vedi anche

WlxInitialize

WlxWkstaLockedSAS

Condividi tramite