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 |