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

注解

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

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

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winwlx.h

另请参阅

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS