PSAM_PASSWORD_NOTIFICATION_ROUTINE回调函数 (ntsecapi.h)

PasswordChangeNotify 函数由密码筛选器 DLL 实现。 它通知 DLL 密码已更改。

语法

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

参数

[in] UserName

密码已更改的用户的帐户名称。

如果此参数和 NewPassword 参数的值为 NULL,则此函数应返回 STATUS_SUCCESS。

[in] RelativeId

UserName 中指定的用户的相对标识符 (RID) 。

[in] NewPassword

UserName 中指定的用户的新纯文本密码。 使用完密码后,通过调用 SecureZeroMemory 函数清除信息。 有关保护密码的详细信息,请参阅 处理密码。

如果此参数和 UserName 参数的值为 NULL,则此函数应返回 STATUS_SUCCESS。

返回值

返回代码 说明
STATUS_SUCCESS
指示用户的密码已更改,或者 UserName 和 NewPassword 参数的值为 NULL。

注解

成功调用 PasswordFilter 函数并存储新密码后,将调用 PasswordChangeNotify 函数。

此函数必须使用 __stdcall 调用约定,并且必须由 DLL 导出。

当 PasswordChangeNotify 例程正在运行时,将阻止处理,直到该例程完成。 适当时,在从此例程返回之前,将任何冗长的处理移动到单独的线程。

仅针对在系统上安装和注册 的密码筛选器 调用此函数。

未在此函数中处理的任何进程异常都可能导致系统范围内的与安全相关的故障。 适当时应使用结构化异常处理。

有关以下方面的信息 请参阅
实现密码筛选器 DLL 时的编程问题 密码筛选器编程注意事项
如何安装和注册自己的密码筛选器 DLL 安装和注册密码筛选器 DLL
Microsoft 提供的密码筛选器 DLL 强密码强制实施和 Passfilt.dll

要求

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

另请参阅

InitializeChangeNotify

PasswordFilter