Функция NPPasswordChangeNotify (npapi.h)

Статья
08/25/2023

Примечание

Этот 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.

Если майкрософт является основным элементом проверки подлинности, для входа в интерактивный контроллер и контроллер служб указывается следующая строка.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Указатель на структуру, содержащую новые учетные данные.

Если основным элементом проверки подлинности является Корпорация Майкрософт (то есть если lpAuthentifoType имеет значение "MSV1_0:Interactive" или "Kerberos:Interactive"), используемая структура используется MSV1_0_INTERACTIVE_LOGON или KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Указатель на строку, определяющую тип структуры, на которую указывает lpPreviousAuthentInfo. Если указатель имеет значение NULL, предыдущие сведения отсутствуют. Ожидаемые здесь значения совпадают с значениями в lpAuthentInfoType.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Указатель на структуру, содержащую учетные данные, используемые до изменения сведений о проверке подлинности. Предварительные сведения предоставляются, если пользователь был вынужден изменить пароль (или другие сведения для проверки подлинности) перед входом в систему. Если пользователь не был вынужден изменить сведения для проверки подлинности, этот указатель имеет значение NULL. Ожидаемые здесь значения совпадают с значениями в lpAuthentInfo.

Если корпорация Майкрософт является основным элементом проверки подлинности, используемая структура MSV1_0_INTERACTIVE_LOGON или KERB_INTERACTIVE_LOGON.

[in] lpStationName

Указатель на строку, указывающую имя станции, в которую вошел пользователь. Имя станции можно использовать для определения возможности получения дополнительных сведений о поставщике.

Если майкрософт является основным элементом проверки подлинности, будет указана одна из следующих строк.

Значение	Значение
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_VALID_LOGON_ACCOUNT

Этот флаг указывает, что измененные сведения о проверке подлинности повлияют на все будущие входы в систему. Пользователь принадлежит к доверенному домену.

WN_NT_PASSWORD_CHANGED

Этот флаг указывает, что пароль был изменен.

Некоторые изменения сведений о проверке подлинности влияют только на подключения, выполненные в недоверенных доменах. Это учетные записи, которые пользователь не может использовать для входа на этот компьютер. В этих случаях параметр dwChangeInfo не задан.

Возвращаемое значение

Если функция завершается успешно, функция возвращает WN_SUCCESS.

Если функция завершается сбоем, она возвращает код ошибки, который может быть одним из следующих значений.

Код возврата	Описание
WN_NOT_SUPPORTED	NPPasswordChangeNotify не поддерживается.
WN_NO_NETWORK	Сеть отсутствует.
WN_FUNCTION_BUSY	Диспетчер учетных данных по-прежнему инициализируется и не готов к вызову.

Windows Server 2003 и Windows XP: NPPasswordChangeNotify вызывается на компьютере, на который пользователь входит, если пароль был изменен в другом месте. Обратите внимание, что это поведение не поддерживается, начиная с Windows Vista и Windows Server 2008.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	npapi.h

См. также раздел

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify