WlxScreenSaverNotify 函数 (winwlx.h)

  • 项目

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

WlxScreenSaverNotify 函数可由替换 GINA DLL 实现。 Winlogon 在激活屏幕保护程序之前立即调用此函数，从而允许 GINA 与屏幕保护程序交互。

注意 在 Windows Vista 中忽略 GINA DLL。
 

语法

BOOL WlxScreenSaverNotify(
  [in]      PVOID pWlxContext,
  [in, out] BOOL  *pSecure
);

参数

[in] pWlxContext

指向与此窗口工作站关联的 GINA 上下文的指针。 当 Winlogon 为此工作站调用 WlxInitialize 时，GINA 将返回此上下文值。

[in, out] pSecure

指向布尔值的指针，该值在输入时指定当前屏幕保护程序是否安全，

，指示工作站是否应锁定。

返回值

如果应激活屏幕保护程序，该函数将返回 TRUE。

如果不应激活屏幕保护程序，则函数返回 FALSE。

注解

如果 GINA DLL 不导出此函数，Winlogon 将使用以下默认行为。

#include <windows.h>
#include <Winwlx.h>

BOOL DefaultScreenSaverNotify(
   PVOID   pWlxContext,
   BOOL    *pSecure)
{
  if (*pSecure)
  {
    *pSecure = WlxIsLockOk(pWlxContext);
  }
  return(TRUE);
}

在调用 WlxScreenSaverNotify 之前，Winlogon 设置桌面状态，使当前桌面为 Winlogon 桌面，并设置工作站状态，使桌面处于锁定状态。

要求

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

另请参阅

WlxInitialize