EventSetInformation 関数 (evntprov.h)

ETW イベント プロバイダーを構成します。

構文

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

パラメーター

[in] RegHandle

イベント プロバイダー登録ハンドル。 これは EventRegister によって返されるハンドルです。

[in] InformationClass

EVENT_INFO_CLASS イベント プロバイダーで実行する構成操作を指定する値です。

[in] EventInformation

イベント プロバイダーの構成時に使用するデータを含むバッファーへのポインター。 このバッファー内のデータの形式は、 InformationClass パラメーターで指定された値によって異なります。

この値は、InformationLength が 0 の場合ですNULL。

[in] InformationLength

EventInformation バッファー内のデータのサイズ (バイト単位)。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

• ERROR_INVALID_PARAMETER: パラメーターが正しくありません。 たとえば、RegHandle パラメーターが有効なプロバイダー登録ハンドルではない場合、EventInformation が NULL で InformationLength が 0 以外の場合、または指定した InformationClass に対して指定された InformationLength が無効な場合、このエラーが返されます。
• ERROR_NOT_SUPPORTED: 要求はサポートされていません。 InformationClass パラメーターが認識された値でない場合、このエラーが返されます。
• その他: FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

要件

関連項目

EVENT_INFO_CLASS

EventRegister