EvtCreateRenderContext-Funktion (winevt.h)
Erstellt einen Kontext, der die Informationen für das Ereignis angibt, das Sie rendern möchten.
Syntax
EVT_HANDLE EvtCreateRenderContext(
[in] DWORD ValuePathsCount,
[in] LPCWSTR *ValuePaths,
[in] DWORD Flags
);
Parameter
[in] ValuePathsCount
Die Anzahl der XPath-Ausdrücke im ValuePaths-Parameter .
[in] ValuePaths
Ein Array von XPath-Ausdrücken, die einen Knoten oder ein Attribut eindeutig identifizieren, wenn Sie rendern möchten.
Legen Sie auf NULL fest, wenn das Kontextflag EvtRenderContextValues im Flags-Parameter nicht festgelegt ist.
Die Ausdrücke dürfen nicht den OR- oder AND-Operator enthalten.
Attributnamen in den Ausdrücken dürfen nicht von einem Leerzeichen gefolgt werden.
[in] Flags
Flag, das die Informationen in dem Ereignis identifiziert, das Sie rendern möchten. Beispielsweise die Systeminformationen, Benutzerinformationen oder bestimmte Werte. Mögliche Werte finden Sie in der EVT_RENDER_CONTEXT_FLAGS-Enumeration .
Rückgabewert
Ein Kontexthandle, das Sie beim Aufrufen der EvtRender-Funktion verwenden, um den Inhalt eines Ereignisses zu rendern; andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.
Hinweise
Um die angegebenen Informationen aus dem Ereignis zu rendern, rufen Sie die EvtRender-Funktion auf.
Sie müssen die EvtClose-Funktion aufrufen, um den Handle zu schließen, wenn Sie fertig sind.
Beispiele
Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Renderereignisse.
Anforderungen
| 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 |