NPPasswordChangeNotify 函数 (npapi.h)

注意

此 API 已弃用,并将在将来的版本中删除。

MPR 调用此函数以通知凭据管理器密码更改事件。 NPPasswordChangeNotify 函数由凭据管理器 DLL 实现。

语法

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

参数

[in] lpAuthentInfoType

指向标识 lpAuthentInfo 指向的结构类型的字符串的指针。

当 Microsoft 是主要验证器时,为交互式和服务控制器登录指定以下字符串。

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

指向包含新凭据的结构的指针。

当 Microsoft 是主要验证器 (即 lpAuthentifoType 为“MSV1_0:Interactive”或“Kerberos:Interactive”) 时,使用的结构 MSV1_0_INTERACTIVE_LOGONKERB_INTERACTIVE_LOGON

[in] lpPreviousAuthentInfoType

指向标识 lpPreviousAuthentInfo 所指向的结构类型的字符串的指针。 如果指针为 NULL,则没有以前的信息。 此处预期的值与 lpAuthentInfoType 中的值相同。

当 Microsoft 是主要验证器时,为交互式和服务控制器登录指定以下字符串。

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

指向结构的指针,该结构包含身份验证信息更改之前使用的凭据。 如果用户在登录前被迫更改密码 (或其他身份验证信息) ,则会提供以前的信息。 如果未强制用户更改身份验证信息,则此指针为 NULL。 此处预期的值与 lpAuthentInfo 中的值相同。

当 Microsoft 是主要验证器时,所使用的结构 MSV1_0_INTERACTIVE_LOGONKERB_INTERACTIVE_LOGON

[in] lpStationName

指向指定用户已登录的工作站名称的字符串的指针。 工作站名称可用于确定是否可以获取其他特定于提供程序的信息。

当 Microsoft 是主要验证器时,将指定以下字符串之一。

含义
WinSta_0
指示这是通过窗口工作站的交互式登录。 在这种情况下, StationHandle 是父对话框的 HWND
SvcCtl
指示这是由服务控制器启动的登录。 在这种情况下,不使用 StationHandle

[in] StationHandle

一个 32 位值,其含义取决于 (的名称,因此, lpStationName 中指定的工作站的类型) 。

含义
WinSta_0
“所有者”对话框的句柄 (hwndOwner) 当前显示在屏幕上。
SvcCtl
随机数据。 请勿使用。

[in] dwChangeInfo

如果已设置,则指定提供更改信息的标志。 此参数可以是标志之一。

含义
WN_VALID_LOGON_ACCOUNT
此标志指示更改的身份验证信息将影响将来的所有登录。 用户属于受信任的域。
WN_NT_PASSWORD_CHANGED
此标志指示密码已更改。

某些身份验证信息更改只会影响在不受信任的域中建立的连接。 这些帐户是用户无法用于登录此计算机的帐户。 在这些情况下,未设置 dwChangeInfo

返回值

如果函数成功,该函数将返回WN_SUCCESS。

如果函数失败,它将返回错误代码,可以是以下值之一。

返回代码 说明
WN_NOT_SUPPORTED

不支持 NPPasswordChangeNotify

WN_NO_NETWORK
网络不存在。
WN_FUNCTION_BUSY
凭据管理器仍在初始化中,尚未准备好调用。

注解

NPPasswordChangeNotify 函数由凭据管理器实现,以在身份验证信息更改时接收通知。

Windows Server 2003 和 Windows XP:如果用户登录到的计算机上调用 NPPasswordChangeNotify,如果密码已更改到其他位置。 请注意,从 Windows Vista 和 Windows Server 2008 开始,不支持此行为。

要求

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

另请参阅

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify