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_LOGON 或 KERB_INTERACTIVE_LOGON。

[in] lpPreviousAuthentInfoType

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

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

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

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

当 Microsoft 是主要验证器时，所使用的结构 MSV1_0_INTERACTIVE_LOGON 或 KERB_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