LSA_REGISTER_NOTIFICATION función de devolución de llamada (ntsecpkg.h)

  • Artículo

Proporciona un mecanismo en el que se notifica el paquete de seguridad . La notificación puede producirse a intervalos fijos, cuando se señala un objeto de evento o durante determinados eventos del sistema.

Sintaxis

LSA_REGISTER_NOTIFICATION LsaRegisterNotification;

HANDLE LsaRegisterNotification(
  [in] SEC_THREAD_START StartFunction,
  [in] PVOID Parameter,
  [in] ULONG NotificationType,
  [in] ULONG NotificationClass,
  [in] ULONG NotificationFlags,
  [in] ULONG IntervalMinutes,
  [in] HANDLE WaitEvent
)
{...}

Parámetros

[in] StartFunction

Función a la que se llama para aceptar la notificación.

[in] Parameter

Argumento de la función especificada en el parámetro StartFunction .

[in] NotificationType

Especifica el tipo de notificación. En la tabla siguiente, se enumeran los valores válidos.

Valor Significado
NOTIFIER_TYPE_INTERVAL
 Notificar a intervalos fijos. Use el parámetro IntervalMinutes para indicar la longitud del intervalo.
NOTIFIER_TYPE_HANDLE_WAIT
 Notifique cuándo se señala el identificador de eventos especificado por el parámetro WaitEvent .
NOTIFIER_TYPE_STATE_CHANGE
 Notifique cuándo hay un cambio en el dominio o el tipo de instalación de la máquina.
NOTIFIER_TYPE_NOTIFY_EVENT
 Notificar cuándo tiene lugar un evento de seguridad. Use el parámetro NotificationClass para especificar el evento de interés.
NOTIFIER_TYPE_IMMEDIATE
 Notifique inmediatamente. Este valor implica NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Especifica la clase de eventos que generan notificaciones. Especifique cero a menos que el parámetro NotificationType esté establecido en NOTIFIER_TYPE_NOTIFY_EVENT.

Valor Significado
NOTIFY_CLASS_PACKAGE_CHANGE
 Se cargó un paquete o se seleccionó un nuevo paquete como paquete preferido. Para obtener más información, vea la sección Comentarios.
NOTIFY_CLASS_ROLE_CHANGE
 Reservado para uso interno.
NOTIFY_CLASS_DOMAIN_CHANGE
 Reservado para uso interno.

[in] NotificationFlags

Especifica marcas que controlan el comportamiento de las notificaciones.

Valor Significado
NOTIFIER_FLAG_NEW_THREAD
 Espere la notificación mediante un nuevo subproceso.
NOTIFIER_FLAG_ONE_SHOT
 Notifique solo una vez.
NOTIFIER_FLAG_SECONDS
 El parámetro IntervalMinutes especifica segundos.

[in] IntervalMinutes

Especifica el retraso de tiempo entre las notificaciones.

[in] WaitEvent

Opcional. Identificador de un objeto de evento. Cuando se señala el objeto, se produce la notificación. Este valor se usa junto con el valor NotificationType NOTIFIER_TYPE_HANDLE_WAIT.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de la notificación.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Si especifica el valor de NOTIFY_CLASS_PACKAGE_CHANGE para el parámetro NotificationClass , los valores siguientes representan cambios válidos.

Valor Descripción
SECPKG_PACKAGE_CHANGE_LOAD Se cargó un paquete.
SECPKG_PACKAGE_CHANGE_UNLOAD Se ha descargado un paquete.
SECPKG_PACKAGE_CHANGE_SELECT Un nuevo paquete se convirtió en el paquete de seguridad preferido.
 

Hay disponible un puntero a la función RegisterNotification en la estructura LSA_SECPKG_FUNCTION_TABLE recibida por la función SpInitialize .

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 ntsecpkg.h

Consulte también

LSA_SECPKG_FUNCTION_TABLE

SpInitialize