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 是主要验证器时,将指定以下字符串之一。
值 | 含义 |
---|---|
|
指示这是通过窗口工作站的交互式登录。 在这种情况下, StationHandle 是父对话框的 HWND 。 |
|
指示这是由服务控制器启动的登录。 在这种情况下,不使用 StationHandle。 |
[in] StationHandle
一个 32 位值,其含义取决于 (的名称,因此, lpStationName 中指定的工作站的类型) 。
值 | 含义 |
---|---|
|
“所有者”对话框的句柄 (hwndOwner) 当前显示在屏幕上。 |
|
随机数据。 请勿使用。 |
[in] dwChangeInfo
如果已设置,则指定提供更改信息的标志。 此参数可以是标志之一。
值 | 含义 |
---|---|
|
此标志指示更改的身份验证信息将影响将来的所有登录。 用户属于受信任的域。 |
|
此标志指示密码已更改。
某些身份验证信息更改只会影响在不受信任的域中建立的连接。 这些帐户是用户无法用于登录此计算机的帐户。 在这些情况下,未设置 dwChangeInfo 。 |
返回值
如果函数成功,该函数将返回WN_SUCCESS。
如果函数失败,它将返回错误代码,可以是以下值之一。
返回代码 | 说明 |
---|---|
|
|
|
网络不存在。 |
|
凭据管理器仍在初始化中,尚未准备好调用。 |
注解
NPPasswordChangeNotify 函数由凭据管理器实现,以在身份验证信息更改时接收通知。
Windows Server 2003 和 Windows XP:如果用户登录到的计算机上调用 NPPasswordChangeNotify,如果密码已更改到其他位置。 请注意,从 Windows Vista 和 Windows Server 2008 开始,不支持此行为。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | npapi.h |