Freigeben über


EvtCreateBookmark-Funktion (winevt.h)

Erstellt ein Lesezeichen, das ein Ereignis in einem Kanal identifiziert.

Syntax

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

Parameter

[in, optional] BookmarkXml

Eine XML-Zeichenfolge, die das Lesezeichen oder NULL beim Erstellen eines Lesezeichens enthält.

Rückgabewert

Ein Handle für das Lesezeichen, wenn der Aufruf erfolgreich ist; andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Um ein Lesezeichen zu erstellen, legen Sie den BookmarkXml-Parameter auf NULL fest. Rufen Sie vor dem Beenden die EvtUpdateBookmark-Funktion auf, um das Lesezeichen zu aktualisieren. Übergeben Sie das Lesezeichenhandle an die EvtRender-Funktion , um das Lesezeichen als XML-Zeichenfolge zu rendern. Sie können die Zeichenfolge dann zur späteren Verwendung beibehalten. Legen Sie BookmarkXml auf die XML-Zeichenfolge fest, die Sie beibehalten haben, um mit der Nutzung von Ereignissen zu beginnen. Übergeben Sie für ein Abonnement das Lesezeichenhandle an die EvtSubscribe-Funktion . Übergeben Sie für eine Abfrage das Lesezeichenhandle an die EvtSeek-Funktion , um ein bestimmtes Ereignis im Abfrageergebnis zu suchen.

Wenn die Abfrage für mehrere Kanäle gilt, enthält das Lesezeichenhandle Lesezeichen für jeden Kanal. Sie können kein Lesezeichen für eine Protokolldatei erstellen.

Sie müssen die EvtClose-Funktion aufrufen, um das Handle zu schließen, wenn Sie fertig sind.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Lesezeichenereignisse.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winevt.h
Bibliothek Wevtapi.lib
DLL Wevtapi.dll

Weitere Informationen

EvtUpdateBookmark