Funzione LsaRegisterPolicyChangeNotification (ntsecapi.h)

  • Articolo

La funzione LsaRegisterPolicyChangeNotification registra un handle eventi con l'autorità di sicurezza locale . Questo handle di eventi viene segnalato ogni volta che viene modificato il criterio LSA indicato.

Sintassi

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

Parametri

[in] InformationClass

Valore POLICY_NOTIFICATION_INFORMATION_CLASS che specifica il tipo di modifiche ai criteri su cui verrà notificata l'applicazione. Specificare uno dei valori seguenti.

Valore Significato
PolicyNotifyAuditEventsInformation
 Modifiche ai criteri di controllo.
PolicyNotifyAccountDomainInformation
 Modifiche alle informazioni sul dominio dell'account.
PolicyNotifyServerRoleInformation
 Modifiche al ruolo del server.
PolicyNotifyDomainEfsInformation
 Modifiche alle informazioni sui criteri EFS.
PolicyNotifyDomainKerberosTicketInformation
 Modifiche alle informazioni sui criteri dei ticket Kerberos.
PolicyNotifyDnsDomainInformation
 Informazioni dns (Domain Name System), nome o SID del dominio primario del sistema cambia.

[in] NotificationEventHandle

Handle per un evento ottenuto chiamando la funzione CreateEvent . L'evento può essere denominato o senza nome.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS. Per altre informazioni, vedere Valori restituiti della funzione criteri LSA.

È possibile utilizzare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Commenti

Al termine dell'utilizzo di un evento di notifica registrato dalla funzione LsaRegisterPolicyChangeNotification, annullare la registrazione chiamando la funzione LsaUnregisterPolicyChangeNotification .

Per un esempio che illustra la chiamata a questa funzione, vedere Ricezione di eventi di modifica dei criteri.

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 ntsecapi.h
Libreria Secur32.lib
DLL Secur32.dll

Vedi anche

LsaUnregisterPolicyChangeNotification