PWLX_SET_RETURN_DESKTOP回调函数 (winwlx.h)

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

由 GINA 调用，以指定在当前安全关注序列 (SAS) 事件处理函数完成时 Winlogon 将切换到的备用应用程序桌面。

注意在 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	函数调用未能设置返回桌面。

只能在 WlxLoggedOnSAS 或 WlxWkstaLockedSAS 例程中调用 WlxSetReturnDesktop。在其他时间尝试调用此函数将失败。

如果提供了桌面的句柄，Winlogon 将复制该句柄。如果未提供句柄，Winlogon 将尝试打开 pDesktop 参数中名为的桌面。如果提供的桌面无效，或者是 Winlogon 或屏幕保护程序桌面，则调用将失败。