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

Функция LsaRegisterPolicyChangeNotification (ntsecapi.h)

  • Статья

Функция LsaRegisterPolicyChangeNotification регистрирует дескриптор события в локальном центре безопасности (LSA). Этот дескриптор события получает сигнал при каждом изменении указанной политики LSA.

Синтаксис

NTSTATUS LsaRegisterPolicyChangeNotification(
  [in] POLICY_NOTIFICATION_INFORMATION_CLASS InformationClass,
  [in] HANDLE                                NotificationEventHandle
);

Параметры

[in] InformationClass

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

Значение Значение
PolicyNotifyAuditEventsInformation
 Изменения политики аудита.
PolicyNotifyAccountDomainInformation
 Изменение сведений о домене учетной записи.
PolicyNotifyServerRoleInformation
 Изменения роли сервера.
PolicyNotifyDomainEfsInformation
 Изменения в политике EFS.
PolicyNotifyDomainKerberosTicketInformation
 Изменения в политике билетов Kerberos.
PolicyNotifyDnsDomainInformation
 Сведения о системе доменных имен (DNS), имя или идентификатор безопасности изменений основного домена системы.

[in] NotificationEventHandle

Дескриптор события, полученного путем вызова функции CreateEvent . Событие может быть именованным или неименованным.

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

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением будет код NTSTATUS. Дополнительные сведения см. в разделе Возвращаемые значения функции политики LSA.

Для преобразования кода NTSTATUS в код ошибки Windows можно использовать функцию LsaNtStatusToWinError .

Комментарии

Завершив использование события уведомления, зарегистрированного функцией LsaRegisterPolicyChangeNotification , отмените его регистрацию, вызвав функцию LsaUnregisterPolicyChangeNotification .

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

Требования

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

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

LsaUnregisterPolicyChangeNotification