EvtSetChannelConfigProperty 函式 (winevt.h)

設定通道的指定組態屬性。

語法

BOOL EvtSetChannelConfigProperty(
  [in] EVT_HANDLE                     ChannelConfig,
  [in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in] DWORD                          Flags,
  [in] PEVT_VARIANT                   PropertyValue
);

參數

[in] ChannelConfig

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

[in] PropertyId

要設定之通道屬性的標識碼。 如需屬性標識碼的清單，請參閱 EVT_CHANNEL_CONFIG_PROPERTY_ID 列舉。

[in] Flags

保留的。 必須為零。

[in] PropertyValue

要設定的屬性值。

呼叫端配置的緩衝區，其中包含新的組態屬性值。 緩衝區包含 EVT_VARIANT 物件。 請務必設定組態值和變體類型。

傳回值

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

備註

此函式會變更組態屬性的記憶體內部複本。 若要套用您對一或多個組態屬性所做的變更，請呼叫 EvtSaveChannelConfig 函式。

範例

如需示範如何使用此函式的範例，請參閱 取得和設定通道的組態屬性。

規格需求

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

另請參閱

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig