Win32 API 日本語リファレンス
ホーム › Security.WinWlx › PWLX_SET_RETURN_DESKTOP

PWLX_SET_RETURN_DESKTOP

コールバック

シグネチャ

BOOL PWLX_SET_RETURN_DESKTOP(
    HANDLE hWlx,
    WLX_DESKTOP* pDesktop
);

パラメーター

フィールド型説明
hWlxHANDLEWlxInitialize の呼び出しで GINA に渡された Winlogon ハンドルを指定します。
pDesktopWLX_DESKTOP*代替デスクトップに関するデスクトップ情報へのポインター。このデスクトップは WlxCreateUserDesktop 関数を呼び出して作成します。

公式ドキュメント

[WlxSetReturnDesktop 関数は、Windows Server 2008 および Windows Vista 以降では使用できません。]

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

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

戻り値

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

戻り値 説明
TRUE
 関数呼び出しは成功しました。
FALSE
 関数呼び出しは、復帰先デスクトップの設定に失敗しました。

解説(Remarks)

WlxSetReturnDesktop は、 WlxLoggedOnSAS または WlxWkstaLockedSAS ルーチン内でのみ呼び出すことができます。それ以外のタイミングで呼び出そうとすると失敗します。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)