Функция AuthzInstallSecurityEventSource (authz.h)

Функция AuthzInstallSecurityEventSource устанавливает указанный источник в качестве источника событий безопасности.

Синтаксис

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

Параметры

[in] dwFlags

Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.

[in] pRegistration

Указатель на структуру AUTHZ_SOURCE_SCHEMA_REGISTRATION , содержащую сведения о добавляемом источнике событий безопасности.

Элементы структуры AUTHZ_SOURCE_SCHEMA_REGISTRATION используются следующим образом для установки источника событий безопасности в ключе журнала безопасности:

• Элемент szEventSourceName добавляется в качестве раздела реестра в разделе

  HKEY_LOCAL_MACHINE
     SYSTEM
        CurrentControlSet
           Services
              EventLog
                 Security

• Элемент szEventMessageFile добавляется в качестве данных в REG_SZ значении с именем EventMessageFile в исходном ключе события.
• Член szEventAccessStringsFile добавляется в качестве данных в REG_SZ значении ParameterMessageFile в ключе источника события.
• Если путь к реестру не существует, он создается.

• Если элемент szEventSourceXmlSchemaFile не имеет значения NULL, он добавляется в качестве данных в REG_SZ значение с именем XmlSchemaFile в ключе источника события. Это значение не используется.
• Член szExecutableImagePath может иметь значение NULL.

Возвращаемое значение

Если функция выполнена успешно, функция возвращает значение TRUE.

Если функция завершается сбоем, она возвращает значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Требования

См. также раздел

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource