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 函数返回以下值之一。
返回代码 | 说明 |
---|---|
|
函数调用成功。 |
|
函数调用未能设置返回桌面。 |
注解
只能在 WlxLoggedOnSAS 或 WlxWkstaLockedSAS 例程中调用 WlxSetReturnDesktop。 在其他时间尝试调用此函数将失败。
如果提供了桌面的句柄,Winlogon 将复制该句柄。 如果未提供句柄,Winlogon 将尝试打开 pDesktop 参数中名为 的桌面。 如果提供的桌面无效,或者是 Winlogon 或屏幕保护程序桌面,则调用将失败。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | winwlx.h |