Share via

Função LsaRegisterPolicyChangeNotification (ntsecapi.h)

  • Artigo

A função LsaRegisterPolicyChangeNotification registra um identificador de evento com a LSA ( autoridade de segurança local ). Esse identificador de evento é sinalizado sempre que a política LSA indicada é modificada.

Sintaxe

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

Parâmetros

[in] InformationClass

Um valor POLICY_NOTIFICATION_INFORMATION_CLASS que especifica o tipo de alterações de política sobre as quais seu aplicativo será notificado. Especifique um dos valores a seguir.

Valor Significado
PolicyNotifyAuditEventsInformation
 Alterações na política de auditoria.
PolicyNotifyAccountDomainInformation
 Alterações nas informações de domínio da conta.
PolicyNotifyServerRoleInformation
 Alterações de função de servidor.
PolicyNotifyDomainEfsInformation
 Alterações nas informações da política do EFS.
PolicyNotifyDomainKerberosTicketInformation
 Alterações nas informações da política de tíquete Kerberos.
PolicyNotifyDnsDomainInformation
 Informações, nome ou SID do DNS (Sistema de Nomes de Domínio) das alterações de domínio primário do sistema.

[in] NotificationEventHandle

Um identificador para um evento obtido chamando a função CreateEvent . O evento pode ser nomeado ou não nomeado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS. Para obter mais informações, consulte Valores retornados da função de política LSA.

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Comentários

Quando terminar de usar um evento de notificação que foi registrado pela função LsaRegisterPolicyChangeNotification, cancele o registro chamando a função LsaUnregisterPolicyChangeNotification .

Para obter um exemplo que demonstra como chamar essa função, consulte Recebendo eventos de alteração de política.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Secur32.lib
DLL Secur32.dll

Confira também

LsaUnregisterPolicyChangeNotification