Функция EvtOpenPublisherMetadata (winevt.h)

Возвращает дескриптор, используемый для чтения метаданных указанного поставщика.

Синтаксис

EVT_HANDLE EvtOpenPublisherMetadata(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    PublisherId,
  [in, optional] LPCWSTR    LogFilePath,
  [in]           LCID       Locale,
  [in]           DWORD      Flags
);

Параметры

[in, optional] Session

Удаленный дескриптор сеанса, возвращаемого функцией EvtOpenSession . Задайте значение NULL , чтобы получить метаданные поставщика на локальном компьютере.

[in] PublisherId

Имя поставщика. Чтобы перечислить имена поставщиков, зарегистрированных на компьютере, вызовите функцию EvtOpenPublisherEnum .

[in, optional] LogFilePath

Полный путь к архивированному файлу журнала, который содержит события, зарегистрированные поставщиком. Архивированный файл журнала также содержит метаданные поставщика. Используйте этот параметр, если поставщик не зарегистрирован на локальном компьютере. При чтении метаданных от зарегистрированного поставщика задайте значение NULL .

[in] Locale

Идентификатор языкового стандарта, используемый при доступе к локализованным метаданным от поставщика. Чтобы создать идентификатор языкового стандарта, используйте макрос MAKELCID. Задайте значение 0, чтобы использовать идентификатор языкового стандарта вызывающего потока.

[in] Flags

Зарезервировано. Должен равняться нулю.

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

В случае успешного выполнения функция возвращает дескриптор метаданным поставщика; в противном случае — NULL. Если значение РАВНО NULL, вызовите функцию GetLastError , чтобы получить код ошибки.

Комментарии

Если указать архивный файл журнала, эта функция будет проверка для метаданных указанного поставщика в файле журнала. Если метаданные поставщика не найдены в файле журнала, функция выполнит поиск поставщика в списке зарегистрированных поставщиков на локальном компьютере.

Чтобы прочитать метаданные поставщика, вызовите функцию EvtGetPublisherMetadataProperty . Чтобы перечислить события, определяемые поставщиком, вызовите функцию EvtOpenEventMetadataEnum .

По завершении необходимо вызвать функцию EvtClose , чтобы закрыть дескриптор метаданных.

Примеры

Пример использования этой функции см. в разделе Получение метаданных поставщика.

Требования

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

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum