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

Weitere Informationen

EvtRender