WlxLoggedOnSAS 関数 (winwlx.h)

  • [アーティクル]

[WlxLoggedOnSAS 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。

WlxLoggedOnSAS 関数は、代替の GINA DLL によって実装する必要があります。 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 の種類を指定します。 0 から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