EvtGetChannelConfigProperty 函式 (winevt.h)

取得指定的通道組態屬性。

語法

BOOL EvtGetChannelConfigProperty(
  [in]  EVT_HANDLE                     ChannelConfig,
  [in]  EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          PropertyValueBufferSize,
  [in]  PEVT_VARIANT                   PropertyValueBuffer,
  [out] PDWORD                         PropertyValueBufferUsed
);

參數

[in] ChannelConfig

EvtOpenChannelConfig 函式傳回之通道組態屬性的句柄。

[in] PropertyId

要擷取之通道屬性的標識碼。 如需屬性標識碼的清單,請參閱 EVT_CHANNEL_CONFIG_PROPERTY_ID 列舉。

[in] Flags

保留的。 必須為零。

[in] PropertyValueBufferSize

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

[in] PropertyValueBuffer

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

[out] PropertyValueBufferUsed

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

傳回值

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

規格需求

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

另請參閱

EvtOpenChannelConfig