共用方式為


WlxLoggedOnSAS 函式 (winwlx.h)

[WlxLoggedOnSAS 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

取代GINA DLL 必須實作WlxLoggedOnSAS函式。 Winlogon 會在使用者登入且工作站未鎖定時收到 安全注意序列 (SAS) 事件時呼叫此函式。

注意 Windows Vista 中會忽略 GINA DLL。
 

語法

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

參數

[in] pWlxContext

與此視窗月臺相關聯的 GINA 內容指標。 當 Winlogon 為此月臺呼叫 WlxInitialize 時,GINA 會傳回此內容值。

[in] dwSasType

指定發生的 SAS 類型。 從零到WLX_SAS_TYPE_MAX_MSFT_VALUE的值會保留來定義標準 Microsoft SAS 類型。 GINA 開發人員可以使用大於WLX_SAS_TYPE_MAX_MSFT_VALUE的值來定義其他 SAS 類型。

預先定義下列 SAS 類型。

意義
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
表示在指定的逾時期間內未收到任何使用者輸入。
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
表示使用者已輸入標準 CTRL+ALT+DEL 安全注意順序 , (SAS) 。
WLX_SAS_TYPE_SC_INSERT
5 (0x5)
表示 智慧卡 已插入相容的裝置。
WLX_SAS_TYPE_SC_REMOVE
6 (0x6)
指出智慧卡已從相容的裝置中移除。

[in] pReserved

此參數是保留的,而且必須設定為 Null

傳回值

WlxLoggedOnSAS函式應該會傳回下列其中一個值。

傳回碼 描述
WLX_SAS_ACTION_NONE
返回預設桌面。
WLX_SAS_ACTION_LOCK_WKSTA
鎖定工作站並等候下一個 SAS。
WLX_SAS_ACTION_LOGOFF
將使用者登出工作站。
WLX_SAS_ACTION_SHUTDOWN
將使用者登出並關閉電腦。
WLX_SAS_ACTION_SHUTDOWN_REBOOT
將使用者登出、關閉電腦,然後重新開機電腦。
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
如果硬體允許,請登出使用者、關閉電腦,然後關閉電腦。
WLX_SAS_ACTION_PWD_CHANGED
通知網路提供者使用者變更其密碼。 當密碼變更時,過時的 GINA DLL 應該呼叫 WlxChangePasswordNotify
WLX_SAS_ACTION_TASKLIST
叫用工作清單。
WLX_SAS_ACTION_FORCE_LOGOFF
強制登出使用者。
WLX_SAS_ACTION_SHUTDOWN_SLEEP
讓電腦處於暫停模式。
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
將系統關閉為 ACPI 電源關閉狀態。 如果電腦不是 ACPI 電腦,此選項將不會有任何作用。
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
將系統關機進入睡眠模式。 如果系統未設定為休眠,此選項將不會有任何作用。

備註

當登入的使用者想要關閉、登出或鎖定工作站時,Winlogon 會呼叫 WlxLoggedOnSASGINA DLL 可以傳回WLX_SAS_ACTION_LOCK_WKSTA來鎖定工作站。 傳回此值時, Winlogon 會鎖定工作站,並在下次收到 SAS 時呼叫 WlxWkstaLockedSAS

在呼叫 WlxLoggedOnSAS之前,Winlogon 會設定桌面狀態,讓目前的桌面是 Winlogon 桌面,並設定工作站狀態,讓桌面鎖定。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winwlx.h

另請參閱

WlxInitialize

WlxWkstaLockedSAS