PWLX_SET_RETURN_DESKTOP回呼函式 (winwlx.h)

[WlxSetReturnDesktop 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

由 GINA 呼叫，以指定 Winlogon 會在目前的安全注意順序 (SAS) 事件處理函式完成時切換至的替代應用程式桌面。

注意 Windows Vista 中會忽略 GINA DLL。

語法

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

[in] hWlx

指定在 WlxInitialize 呼叫中傳遞至 GINA 的 Winlogon 控制碼。

[in] pDesktop

關於替代桌面的桌面資訊的指標。此桌面的建立方式是呼叫 WlxCreateUserDesktop 函式。

WlxSetReturnDesktop函式會傳回下列其中一個值。

傳回碼	描述
TRUE	函式呼叫成功。
FALSE	函式呼叫無法設定傳回桌面。

WlxSetReturnDesktop 只能在 WlxLoggedOnSAS 或 WlxWkstaLockedSAS 常式內呼叫。嘗試在其他時間呼叫此函式將會失敗。

如果提供桌面的控制碼，Winlogon 將會複製控制碼。如果未提供控制碼，Winlogon 會嘗試開啟 pDesktop 參數中名為的桌面。如果提供的桌面無效或 Winlogon 或螢幕保護裝置桌面，則呼叫將會失敗。