ホーム › Security.WinWlx › PWLX_CREATE_USER_DESKTOP

PWLX_CREATE_USER_DESKTOP

コールバック

シグネチャ

BOOL PWLX_CREATE_USER_DESKTOP(
    HANDLE hWlx,
    HANDLE hToken,
    DWORD Flags,
    LPWSTR pszDesktopName,
    WLX_DESKTOP** ppDesktop
);

パラメーター

フィールド

型

説明

hWlx

HANDLE

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

hToken

HANDLE

デスクトップの作成対象となるユーザーのトークンへのハンドルを指定します。

Flags

DWORD

デスクトップへのアクセスを指定します。次のいずれかを指定します。

値	意味
WLX_CREATE_INSTANCE_ONLY	このユーザーのこのインスタンスのみがアクセスできることを指定します。
WLX_CREATE_USER	このユーザーの任意のインスタンスがアクセスできることを指定します。

pszDesktopName

LPWSTR

作成するデスクトップの名前を指定します。

ppDesktop

WLX_DESKTOP**

デスクトップが作成された場合、新しいデスクトップの WLX_DESKTOP 構造体へのポインターを返します。このポインターを WlxSetReturnDesktop の呼び出しに使用すると、SAS イベントの処理後にこのデスクトップを現在のデスクトップにできます。

公式ドキュメント

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

ユーザー用の代替アプリケーションデスクトップを作成するために GINA から呼び出されます。

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

戻り値

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

リターンコード	説明
TRUE	デスクトップが作成されました。
FALSE	デスクトップは作成されませんでした。

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