PWLX_SET_RETURN_DESKTOP コールバック関数 (winwlx.h)

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

現在の Secure Attention Sequence (SAS) イベント処理関数が完了したときに Winlogon が切り替える代替アプリケーション デスクトップを指定するために、GINA によって呼び出されます。

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

 

構文

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

パラメーター

[in] hWlx

WlxInitialize 呼び出しで GINA に渡される Winlogon ハンドルを指定します。

[in] pDesktop

代替デスクトップに関するデスクトップ情報へのポインター。 このデスクトップは、 WlxCreateUserDesktop 関数を呼び出すことによって作成されます。

戻り値

WlxSetReturnDesktop 関数は、次のいずれかの値を返します。

リターン コード	説明
TRUE	関数呼び出しは成功しました。
FALSE	関数呼び出しで、戻り値のデスクトップを設定できませんでした。

解説

WlxSetReturnDesktop は、 WlxLoggedOnSAS ルーチンまたは WlxWkstaLockedSAS ルーチン内でのみ呼び出すことができます。 他の時点でこの関数を呼び出そうとすると失敗します。

デスクトップへのハンドルが指定されている場合、Winlogon はハンドルを複製します。 ハンドルが指定されていない場合、Winlogon は pDesktop パラメーターで という名前のデスクトップを開こうとします。 指定されたデスクトップが無効な場合、または Winlogon またはスクリーン セーバー デスクトップの場合、呼び出しは失敗します。

要件

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

関連項目

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS