共用方式為

EvtGetEventInfo 函式 (winevt.h)

  • 發行項

取得資訊，識別選取事件和包含事件的通道或記錄檔的結構化 XML 查詢。

語法

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

參數

[in] Event

您想要擷取資訊的事件控制碼。

[in] PropertyId

旗標，識別要擷取的資訊。 例如，查詢識別碼或路徑。 如需可能的值，請參閱 EVT_EVENT_PROPERTY_ID 列舉。

[in] PropertyValueBufferSize

PropertyValueBuffer緩衝區的大小，以位元組為單位。

[in] PropertyValueBuffer

將接收資訊的呼叫端配置緩衝區。 緩衝區包含 EVT_VARIANT 物件。 您可以將此參數設定為 Null ，以判斷所需的緩衝區大小。

[out] PropertyValueBufferUsed

如果函式因ERROR_INSUFFICIENT_BUFFER而失敗，則呼叫端配置緩衝區的大小，或是所需的緩衝區大小。

傳回值

傳回碼/值 描述
TRUE
 此函數已成功。
FALSE
 函式失敗。 使用 GetLastError 函式來取得錯誤碼。

備註

如果您傳遞至 EvtQuery 或 EvtSubscribe 的查詢是 XPath，而不是結構化 XML 查詢，則查詢識別碼會是零，而路徑將是您傳遞至函式的路徑。

規格需求

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