EvtCreateRenderContext 函式 (winevt.h)

建立內容，指定您想要呈現之事件中的資訊。

語法

EVT_HANDLE EvtCreateRenderContext(
  [in] DWORD   ValuePathsCount,
  [in] LPCWSTR *ValuePaths,
  [in] DWORD   Flags
);

參數

[in] ValuePathsCount

ValuePaths 參數中的 XPath 運算式數目。

[in] ValuePaths

XPath 表達式的陣列，可唯一識別您想要轉譯之事件中的節點或屬性。

如果未在 Flags 參數中設定 EvtRenderContextValues 內容旗標，則設定為 NULL。

表達式不得包含 OR 或 AND 運算元。

表達式中的屬性名稱不得後面加上空格。

[in] Flags

旗標，識別您想要轉譯之事件中的資訊。 例如，系統資訊、使用者資訊或特定值。 如需可能的值，請參閱 EVT_RENDER_CONTEXT_FLAGS 列舉。

傳回值

呼叫 EvtRender 函式以轉譯事件內容時所使用的內容句柄;否則為 NULL。 如果為 NULL，請呼叫 GetLastError 函 式以取得錯誤碼。

備註

若要從 事件轉譯指定的資訊，請呼叫 EvtRender 函式。

您必須呼叫 EvtClose 函式，才能在完成時關閉句柄。

範例

如需示範如何使用此函式的範例，請參閱 轉譯事件。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	winevt.h
程式庫	Wevtapi.lib
Dll	Wevtapi.dll

另請參閱

EvtRender