Функция 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 .
Примеры
Пример использования этой функции см. в разделе События отрисовки.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |