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 會呼叫 WlxLoggedOnSAS 。 GINA DLL 可以傳回WLX_SAS_ACTION_LOCK_WKSTA來鎖定工作站。 傳回此值時， Winlogon 會鎖定工作站，並在下次收到 SAS 時呼叫 WlxWkstaLockedSAS 。

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

規格需求

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

另請參閱

WlxInitialize

WlxWkstaLockedSAS