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 関数を呼び出します。

注釈

この関数は、構成プロパティのメモリ内コピーを変更します。 1 つ以上の構成プロパティに加えた変更を適用するには、 EvtSaveChannelConfig 関数を呼び出します。

例

この関数の使用方法を示す例については、「チャネルの 構成プロパティの取得と設定」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winevt.h
Library	Wevtapi.lib
[DLL]	Wevtapi.dll

こちらもご覧ください

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig