LSA_REGISTER_NOTIFICATION função de retorno de chamada (ntsecpkg.h)

  • Artigo

Fornece um mecanismo pelo qual o pacote de segurança é notificado. A notificação pode ocorrer em intervalos fixos, quando um objeto de evento é sinalizado ou durante determinados eventos do sistema.

Sintaxe

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

A função que é chamada para aceitar a notificação.

[in] Parameter

O argumento da função especificada no parâmetro StartFunction .

[in] NotificationType

Especifica o tipo de notificação. A tabela a seguir lista os valores válidos.

Valor Significado
NOTIFIER_TYPE_INTERVAL
 Notificar em intervalos fixos. Use o parâmetro IntervalMinutes para indicar o comprimento do intervalo.
NOTIFIER_TYPE_HANDLE_WAIT
 Notifique quando o identificador de evento especificado pelo parâmetro WaitEvent for sinalizado.
NOTIFIER_TYPE_STATE_CHANGE
 Notifique quando houver uma alteração no domínio ou no tipo de instalação do computador.
NOTIFIER_TYPE_NOTIFY_EVENT
 Notifique quando ocorrer um evento de segurança. Use o parâmetro NotificationClass para especificar o evento de interesse.
NOTIFIER_TYPE_IMMEDIATE
 Notifique imediatamente. Esse valor implica NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Especifica a classe de eventos que geram notificações. Especifique zero, a menos que o parâmetro NotificationType esteja definido como NOTIFIER_TYPE_NOTIFY_EVENT.

Valor Significado
NOTIFY_CLASS_PACKAGE_CHANGE
 Um pacote foi carregado ou um novo pacote foi selecionado como o pacote preferencial. Para obter mais informações, consulte Comentários.
NOTIFY_CLASS_ROLE_CHANGE
 Reservado para uso interno.
NOTIFY_CLASS_DOMAIN_CHANGE
 Reservado para uso interno.

[in] NotificationFlags

Especifica sinalizadores que controlam o comportamento de notificação.

Valor Significado
NOTIFIER_FLAG_NEW_THREAD
 Aguarde a notificação usando um novo thread.
NOTIFIER_FLAG_ONE_SHOT
 Notifique apenas uma vez.
NOTIFIER_FLAG_SECONDS
 O parâmetro IntervalMinutes especifica segundos.

[in] IntervalMinutes

Especifica o atraso de tempo entre as notificações.

[in] WaitEvent

Opcional. Identificador para um objeto de evento. Quando o objeto é sinalizado, a notificação ocorre. Esse valor é usado em conjunto com o valor NotificationType NOTIFIER_TYPE_HANDLE_WAIT.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para a notificação.

Se a função falhar, o valor retornado será NULL.

Comentários

Se você especificar o valor NOTIFY_CLASS_PACKAGE_CHANGE para o parâmetro NotificationClass , os valores a seguir representarão alterações válidas.

Valor Descrição
SECPKG_PACKAGE_CHANGE_LOAD Um pacote foi carregado.
SECPKG_PACKAGE_CHANGE_UNLOAD Um pacote foi descarregado.
SECPKG_PACKAGE_CHANGE_SELECT Um novo pacote tornou-se o pacote de segurança preferencial.
 

Um ponteiro para a função RegisterNotification está disponível na estrutura LSA_SECPKG_FUNCTION_TABLE recebida pela função SpInitialize .

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

Confira também

LSA_SECPKG_FUNCTION_TABLE

SpInitialize