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

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

GINA によって呼び出され、ユーザー用の代替アプリケーション デスクトップが作成されます。

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

 

構文

PWLX_CREATE_USER_DESKTOP PwlxCreateUserDesktop;

BOOL PwlxCreateUserDesktop(
  [in]  HANDLE hWlx,
  [in]  HANDLE hToken,
  [in]  DWORD Flags,
  [in]  PWSTR pszDesktopName,
  [out] PWLX_DESKTOP *ppDesktop
)
{...}

パラメーター

[in] hWlx

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

[in] hToken

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

[in] Flags

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

値	説明
WLX_CREATE_INSTANCE_ONLY	ユーザーのこのインスタンスのみがアクセス権を持っていることを指定します。
WLX_CREATE_USER	このユーザーの任意のインスタンスがアクセス権を持っていることを指定します。

[in] pszDesktopName

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

[out] ppDesktop

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

戻り値

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

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

要件

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

関連項目

WlxInitialize

WlxSetReturnDesktop