EvtGetPublisherMetadataProperty 函式 (winevt.h)

取得指定的提供者元數據屬性。

語法

BOOL EvtGetPublisherMetadataProperty(
  [in]  EVT_HANDLE                         PublisherMetadata,
  [in]  EVT_PUBLISHER_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                              Flags,
  [in]  DWORD                              PublisherMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                       PublisherMetadataPropertyBuffer,
  [out] PDWORD                             PublisherMetadataPropertyBufferUsed
);

參數

[in] PublisherMetadata

EvtOpenPublisherMetadata 函式傳回之元數據的句柄。

[in] PropertyId

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

[in] Flags

保留的。 必須為零。

[in] PublisherMetadataPropertyBufferSize

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

[in] PublisherMetadataPropertyBuffer

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

[out] PublisherMetadataPropertyBufferUsed

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

傳回值

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

備註

注意  

EvtGetEventMetadataProperty 可以在 EventMetadataPropertyBuffer 變數中傳回許多不同類型的值。 如果 EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle，則 EventMetadataPropertyBuffer 包含需要釋放的句柄。 當您完成句柄時，請呼叫 EvtClose 函式。

 

範例

如需示範如何使用此函式的範例，請參閱 取得提供者的元數據。

規格需求

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

另請參閱

EvtOpenPublisherMetadata