Funzione WlxLoggedOnSAS (winwlx.h)

  • Articolo

[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