EvtCreateBookmark 함수(winevt.h)

채널에서 이벤트를 식별하는 책갈피를 만듭니다.

구문

EVT_HANDLE EvtCreateBookmark(
  [in, optional] LPCWSTR BookmarkXml
);

매개 변수

[in, optional] BookmarkXml

책갈피를 만드는 경우 책갈피 또는 NULL 이 포함된 XML 문자열입니다.

반환 값

호출이 성공하면 책갈피에 대한 핸들입니다. 그렇지 않으면 NULL입니다. NULL인 경우 GetLastError 함수를 호출하여 오류 코드를 가져옵니다.

설명

책갈피를 만들려면 BookmarkXml 매개 변수를 NULL로 설정합니다. 종료하기 전에 EvtUpdateBookmark 함수를 호출하여 책갈피를 업데이트합니다. 책갈피 핸들을 EvtRender 함수에 전달하여 책갈피를 XML 문자열로 렌더링합니다. 그런 다음 나중에 사용할 문자열을 유지할 수 있습니다. 마지막으로 중단한 위치에서 이벤트 사용을 시작하려면 BookmarkXml 을 유지한 XML 문자열로 설정합니다. 구독의 경우 책갈피 핸들을 EvtSubscribe 함수에 전달합니다. 쿼리의 경우 책갈피 핸들을 EvtSeek 함수에 전달하여 쿼리 결과의 특정 이벤트를 찾습니다.

쿼리가 여러 채널에 대해 있는 경우 책갈피 핸들에는 각 채널에 대한 책갈피가 포함됩니다. 로그 파일에 대한 책갈피를 만들 수 없습니다.

완료되면 EvtClose 함수를 호출하여 핸들을 닫아야 합니다.

예제

이 함수를 사용하는 방법을 보여 주는 예제는 이벤트 책갈피 지정을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winevt.h
라이브러리	Wevtapi.lib
DLL	Wevtapi.dll

추가 정보

EvtUpdateBookmark