LSA_REGISTER_NOTIFICATION funzione di callback (ntsecpkg.h)

  • Articolo

Fornisce un meccanismo in cui il pacchetto di sicurezza viene notificato. La notifica può verificarsi a intervalli fissi, quando un oggetto evento viene segnalato o durante determinati eventi di sistema.

Sintassi

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
)
{...}

Parametri

[in] StartFunction

Funzione chiamata per accettare la notifica.

[in] Parameter

Argomento della funzione specificata nel parametro StartFunction .

[in] NotificationType

Specifica il tipo di notifica. Nella tabella seguente sono elencati i valori validi.

Valore Significato
NOTIFIER_TYPE_INTERVAL
 Notifica a intervalli fissi. Usare il parametro IntervalMinutes per indicare la lunghezza dell'intervallo.
NOTIFIER_TYPE_HANDLE_WAIT
 Notifica quando viene segnalato l'handle evento specificato dal parametro WaitEvent .
NOTIFIER_TYPE_STATE_CHANGE
 Notifica quando si verifica una modifica nel dominio o nel tipo di installazione del computer.
NOTIFIER_TYPE_NOTIFY_EVENT
 Notifica quando si verifica un evento di sicurezza. Usare il parametro NotificationClass per specificare l'evento di interesse.
NOTIFIER_TYPE_IMMEDIATE
 Notifica immediatamente. Questo valore implica NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Specifica la classe di eventi che generano notifiche. Specificare zero a meno che il parametro NotificationType non sia impostato su NOTIFIER_TYPE_NOTIFY_EVENT.

Valore Significato
NOTIFY_CLASS_PACKAGE_CHANGE
 È stato caricato un pacchetto oppure è stato selezionato un nuovo pacchetto come pacchetto preferito. Per altre informazioni, vedere la sezione Osservazioni.
NOTIFY_CLASS_ROLE_CHANGE
 Riservato per utilizzo interno.
NOTIFY_CLASS_DOMAIN_CHANGE
 Riservato per utilizzo interno.

[in] NotificationFlags

Specifica i flag che controllano il comportamento di notifica.

Valore Significato
NOTIFIER_FLAG_NEW_THREAD
 Attendere la notifica usando un nuovo thread.
NOTIFIER_FLAG_ONE_SHOT
 Notifica una sola volta.
NOTIFIER_FLAG_SECONDS
 Il parametro IntervalMinutes specifica i secondi.

[in] IntervalMinutes

Specifica il ritardo di tempo tra le notifiche.

[in] WaitEvent

facoltativo. Handle in un oggetto evento. Quando l'oggetto viene segnalato, si verifica la notifica. Questo valore viene usato insieme al valore NotificationType NOTIFIER_TYPE_HANDLE_WAIT.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per la notifica.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Se si specifica il valore NOTIFY_CLASS_PACKAGE_CHANGE per il parametro NotificationClass , i valori seguenti rappresentano modifiche valide.

Valore Descrizione
SECPKG_PACKAGE_CHANGE_LOAD È stato caricato un pacchetto.
SECPKG_PACKAGE_CHANGE_UNLOAD Un pacchetto è stato scaricato.
SECPKG_PACKAGE_CHANGE_SELECT Un nuovo pacchetto è diventato il pacchetto di sicurezza preferito.
 

Un puntatore alla funzione RegisterNotification è disponibile nella struttura LSA_SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpInitialize .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecpkg.h

Vedi anche

LSA_SECPKG_FUNCTION_TABLE

SpInitialize