Compartilhar via


Função AuthzInstallSecurityEventSource (authz.h)

A função AuthzInstallSecurityEventSource instala a origem especificada como uma fonte de evento de segurança.

Sintaxe

AUTHZAPI BOOL AuthzInstallSecurityEventSource(
  [in] DWORD                             dwFlags,
  [in] PAUTHZ_SOURCE_SCHEMA_REGISTRATION pRegistration
);

Parâmetros

[in] dwFlags

Esse parâmetro é reservado para uso futuro e deve ser definido como zero.

[in] pRegistration

Um ponteiro para uma estrutura AUTHZ_SOURCE_SCHEMA_REGISTRATION que contém informações sobre a origem do evento de segurança a ser adicionada.

Os membros da estrutura AUTHZ_SOURCE_SCHEMA_REGISTRATION são usados da seguinte maneira para instalar a origem do evento de segurança na chave de log de segurança:

  • O membro szEventSourceName é adicionado como uma chave do Registro em
    HKEY_LOCAL_MACHINE
       SYSTEM
          CurrentControlSet
             Services
                EventLog
                   Security
  • O membro szEventMessageFile é adicionado como os dados em um valor REG_SZ chamado EventMessageFile na chave de origem do evento.
  • O membro szEventAccessStringsFile é adicionado como os dados em um valor REG_SZ chamado ParameterMessageFile na chave de origem do evento.
  • Se o caminho do Registro não existir, ele será criado.
  • Se o membro szEventSourceXmlSchemaFile não for NULL, ele será adicionado como os dados em um valor REG_SZ chamado XmlSchemaFile sob a chave de origem do evento. Este valor não é usado.
  • O membro szExecutableImagePath pode ser definido como NULL.

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.

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

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource