Função AuthzRegisterSecurityEventSource (authz.h)

  • Artigo

A função AuthzRegisterSecurityEventSource registra uma origem de evento de segurança com a LSA (Autoridade de Segurança Local ).

Sintaxe

AUTHZAPI BOOL AuthzRegisterSecurityEventSource(
  [in]  DWORD                                 dwFlags,
  [in]  PCWSTR                                szEventSourceName,
  [out] PAUTHZ_SECURITY_EVENT_PROVIDER_HANDLE phEventProvider
);

Parâmetros

[in] dwFlags

Esse parâmetro é reservado para uso futuro. Defina esse parâmetro como zero.

[in] szEventSourceName

Um ponteiro para o nome da origem do evento de segurança a ser registrada.

[out] phEventProvider

Um ponteiro para um identificador para a origem do evento de segurança registrado.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função valida o parâmetro szEventSourceName e configura as estruturas apropriadas e as conexões RPC para registrar eventos com esse nome de origem. A validação é tratada por uma chamada subjacente a uma API LSA.

A API LSA verifica o seguinte:

  • O chamador tem o direito de acesso SeAuditPrivilege.
  • A origem do evento ainda não está em uso.
  • A origem do evento está registrada.
  • O aplicativo de chamada corresponde ao caminho da imagem executável no registro de origem do evento, se houver.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho authz.h
Biblioteca Authz.lib
DLL Authz.dll
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AuthzUnregisterSecurityEventSource