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 对象。 请务必设置配置值和变体类型。

返回值

返回代码/值 说明
TRUE
 函数成功。
FALSE
 函数失败。 若要获取错误代码，请调用 GetLastError 函数。

注解

此函数更改配置属性的内存中副本。 若要将所做的更改应用于一个或多个配置属性，请调用 EvtSaveChannelConfig 函数。

示例

有关演示如何使用此函数的示例，请参阅 获取和设置频道的配置属性。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winevt.h
Library Wevtapi.lib
DLL Wevtapi.dll

另请参阅

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig