Поделиться через

функция обратного вызова 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

Относительный идентификатор (RID) пользователя, указанного в поле UserName.

[in] NewPassword

Новый пароль в виде открытого текста для пользователя, указанного в поле UserName. Завершив использование пароля, очистите сведения, вызвав функцию SecureZeroMemory . Дополнительные сведения о защите паролей см. в разделе Обработка паролей.

Если значения этого параметра и параметра UserName имеют значение NULL, эта функция должна возвращать STATUS_SUCCESS.

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

Код возврата Описание
STATUS_SUCCESS
 Указывает, что пароль пользователя был изменен или что значения параметров UserName и NewPassword имеют значение NULL.

Комментарии

Функция PasswordChangeNotify вызывается после успешного вызова функции PasswordFilter и сохранения нового пароля.

Эта функция должна использовать соглашение о вызовах __stdcall и должна быть экспортирована библиотекой DLL.

При выполнении процедуры PasswordChangeNotify обработка блокируется до ее завершения. При необходимости переместите любую длительную обработку в отдельный поток перед возвращением из этой процедуры.

Эта функция вызывается только для фильтров паролей, установленных и зарегистрированных в системе.

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

Сведения о См.
Проблемы программирования при реализации библиотеки DLL фильтра паролей Рекомендации по программированию фильтра паролей
Установка и регистрация собственной библиотеки DLL фильтра паролей Установка и регистрация библиотеки DLL фильтра паролей
Библиотека DLL фильтра паролей, предоставляемая корпорацией Майкрософт Принудительное применение надежных паролей и Passfilt.dll

Требования

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

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

InitializeChangeNotify

PasswordFilter