PWLX_CREATE_USER_DESKTOP回调函数 (winwlx.h)

[自 Windows Server 2008 和 Windows Vista 起,WlxCreateUserDesktop 函数不再可供使用。]

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

指定对桌面的访问。 指定以下选项之一。

Value 含义
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