evtOpenChannelConfig 函数 (winevt.h)

获取用于读取或修改通道配置属性的句柄。

语法

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 函数返回的远程会话句柄。设置为 NULL 以访问本地计算机上的通道。

[in] ChannelPath

要访问的通道的名称。

[in] Flags

保留。必须为零。

如果成功，函数将返回通道配置的句柄;否则为 NULL。如果 为 NULL，则调用 GetLastError 函数以获取错误代码。

若要获取配置属性，请调用 EvtGetChannelConfigProperty 函数。

若要修改配置属性，请调用 EvtSetChannelConfigProperty 函数。若要保存配置更改，请调用 EvtSaveChannelConfig 函数。

若要枚举已注册的通道，请调用 EvtOpenChannelEnum 函数。

完成后，必须调用 EvtClose 函数以关闭句柄。

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