EvtCreateRenderContext-Funktion (winevt.h)

  • Artikel

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

Weitere Informationen

EvtRender