共用方式為

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