WlxWkstaLockedSAS 関数 (winwlx.h)

  • [アーティクル]

WlxWkstaLockedSAS 関数は、代わりの GINA DLL によって実装される必要があります。 Winlogon は 、 セキュリティで保護されたアテンション シーケンス (SAS) を受け取り、ワークステーションがロックされている場合に、この関数を呼び出します。 GINA は、ワークステーションをロックしたままにするか、ワークステーションのロックを解除するか、ログオンユーザーをログオフ (ログオフが完了するまでワークステーションをロックしたままにする) ことを示す値を返す必要があります。

メモ Windows Vista では GINA DLL は無視されます。
 

構文

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

パラメーター

[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_CTRL_ALT_DEL
 ユーザーが標準の Ctrl + Alt + DEL セキュア アテンション シーケンス (SAS) を入力したことを示します。
WLX_SAS_TYPE_SC_INSERT
 スマート カードが互換性のあるデバイスに挿入されたことを示します。
WLX_SAS_TYPE_SC_REMOVE
 スマート カードが互換性のあるデバイスから削除されたことを示します。
WLX_SAS_TYPE_TIMEOUT
 指定されたタイムアウト期間内にユーザー入力が受信されなかったことを示します。

戻り値

WlxWkstaLockedSAS 関数は、次の値を返す必要があります。

リターン コード 説明
WLX_SAS_ACTION_NONE
 ワークステーションをロックしたままにするよう Winlogon に指示します。
WLX_SAS_ACTION_FORCE_LOGOFF
 ユーザーを強制的にログオフするように Winlogon に指示します。
WLX_SAS_ACTION_LOGOFF
 現在のユーザーをログオフするように Winlogon に指示します。
WLX_SAS_ACTION_UNLOCK_WKSTA
 ワークステーションのロックを解除するように Winlogon に指示します。

注釈

WlxWkstaLockedSAS を呼び出す前に、Winlogon は、現在のデスクトップが Winlogon デスクトップになるようにデスクトップの状態を設定し、デスクトップがロックされるようにワークステーションの状態を設定します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winwlx.h

こちらもご覧ください

WlxInitialize