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 を使用して、返されたエラーのメッセージ文字列を取得します。
要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | evntprov.h |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |