Función LsaRegisterPolicyChangeNotification (ntsecapi.h)

  • Artículo

La función LsaRegisterPolicyChangeNotification registra un identificador de evento con la autoridad de seguridad local (LSA). Este identificador de eventos se señala cada vez que se modifica la directiva LSA indicada.

Sintaxis

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

Parámetros

[in] InformationClass

Valor POLICY_NOTIFICATION_INFORMATION_CLASS que especifica el tipo de cambios de directiva sobre los que se notificará a la aplicación. Especifique uno de los valores siguientes.

Valor Significado
PolicyNotifyAuditEventsInformation
 Cambios en la directiva de auditoría.
PolicyNotifyAccountDomainInformation
 Cambios en la información del dominio de la cuenta.
PolicyNotifyServerRoleInformation
 Cambios en el rol de servidor.
PolicyNotifyDomainEfsInformation
 Cambios en la información de la directiva de EFS.
PolicyNotifyDomainKerberosTicketInformation
 Cambios en la información de la directiva de vales de Kerberos.
PolicyNotifyDnsDomainInformation
 Información del Sistema de nombres de dominio (DNS), nombre o SID del dominio principal del sistema cambia.

[in] NotificationEventHandle

Identificador de un evento obtenido mediante una llamada a la función CreateEvent . El evento se puede denominar o sin nombre.

Valor devuelto

Si la función se realiza correctamente, se STATUS_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS. Para obtener más información, vea Valores devueltos de la función de directiva LSA.

Puede usar la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

Comentarios

Cuando haya terminado de usar un evento de notificación registrado por la función LsaRegisterPolicyChangeNotification , anule el registro llamando a la función LsaUnregisterPolicyChangeNotification .

Para obtener un ejemplo que muestra cómo llamar a esta función, consulte Recepción de eventos de cambio de directiva.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Secur32.lib
Archivo DLL Secur32.dll

Consulte también

LsaUnregisterPolicyChangeNotification