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

Создает контекст, указывающий сведения в событии, которое требуется отобразить.

Синтаксис

EVT_HANDLE EvtCreateRenderContext(
  [in] DWORD   ValuePathsCount,
  [in] LPCWSTR *ValuePaths,
  [in] DWORD   Flags
);

Параметры

[in] ValuePathsCount

Количество выражений XPath в параметре ValuePaths .

[in] ValuePaths

Массив выражений XPath, которые однозначно идентифицируют узел или атрибут в событии, которое требуется отобразить.

Установите значение NULL , если флаг контекста EvtRenderContextValues не задан в параметре Flags .

Выражения не должны содержать оператор OR или AND .

За именами атрибутов в выражениях не должно следовать пробел.

[in] Flags

Флаг, идентифицирующий сведения в событии, которое требуется отобразить. Например, сведения о системе, сведения о пользователе или конкретные значения. Возможные значения см. в перечислении EVT_RENDER_CONTEXT_FLAGS .

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

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

Комментарии

Чтобы отобразить указанные сведения из события, вызовите функцию EvtRender .

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

Примеры

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

Требования

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

EvtRender