EvtGetEventMetadataProperty 函式 (winevt.h)

取得指定的事件元數據屬性。

語法

BOOL EvtGetEventMetadataProperty(
  [in]  EVT_HANDLE                     EventMetadata,
  [in]  EVT_EVENT_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          EventMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                   EventMetadataPropertyBuffer,
  [out] PDWORD                         EventMetadataPropertyBufferUsed
);

參數

[in] EventMetadata

EvtNextEventMetadata 函式傳回的事件元數據句柄。

[in] PropertyId

要擷取之元數據屬性的標識碼。 如需屬性標識碼的清單，請參閱 EVT_EVENT_METADATA_PROPERTY_ID 列舉。

[in] Flags

保留的。 必須為零。

[in] EventMetadataPropertyBufferSize

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

[in] EventMetadataPropertyBuffer

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

[out] EventMetadataPropertyBufferUsed

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

傳回值

傳回碼/值	Description
TRUE	此函數已成功。
FALSE	函式失敗。 若要取得錯誤碼，請呼叫 GetLastError 函式。

規格需求

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

另請參閱

EvtGetPublisherMetadataProperty

EvtNextEventMetadata