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 |