Функция EvtCreateBookmark (winevt.h)
Создает закладку, которая идентифицирует событие в канале.
Синтаксис
EVT_HANDLE EvtCreateBookmark(
[in, optional] LPCWSTR BookmarkXml
);
Параметры
[in, optional] BookmarkXml
XML-строка, содержащая закладку или значение NULL при создании закладки.
Возвращаемое значение
Дескриптор закладки, если вызов выполнен успешно; в противном случае — NULL. Если значение РАВНО NULL, вызовите функцию GetLastError , чтобы получить код ошибки.
Комментарии
Чтобы создать закладку, задайте для параметра BookmarkXmlзначение NULL. Перед выходом вызовите функцию EvtUpdateBookmark , чтобы обновить закладку. Передайте дескриптор закладки в функцию EvtRender , чтобы отобразить закладку в виде XML-строки. Затем можно сохранить строку для последующего использования. Чтобы начать использовать события с того места, с которого вы в последний раз зашли, задайте для BookmarkXml сохраненную XML-строку. Для подписки передайте дескриптор закладки в функцию EvtSubscribe . Для запроса передайте дескриптор закладки в функцию EvtSeek , чтобы найти определенное событие в результатах запроса.
Если запрос выполняется для нескольких каналов, дескриптор закладки будет содержать закладки для каждого канала. Невозможно создать закладку для файла журнала.
Чтобы закрыть дескриптор по завершении, необходимо вызвать функцию EvtClose .
Примеры
Пример использования этой функции см. в разделе События закладки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |