UnregisterTraceGuids 関数 (evntrace.h)
UnregisterTraceGuids 関数は、RegisterTraceGuids を使用して登録されたクラシック (Windows 2000 スタイル) ETW イベント トレース プロバイダーの登録を解除します。
構文
ULONG WMIAPI UnregisterTraceGuids(
[in] TRACEGUID_HANDLE RegistrationHandle
);
パラメーター
[in] RegistrationHandle
RegisterTraceGuids 関数の以前の呼び出しから取得したイベント トレース プロバイダーへのハンドル。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は システム エラー コードの 1 つです。 一般的なエラーとその原因を次に示します。
ERROR_INVALID_PARAMETER
RegistrationHandle パラメーターは、登録済みプロバイダーへのハンドルを指定しないか、NULL です。
注釈
プロバイダーはこの関数を呼び出します。
イベント トレース プロバイダーは、 RegisterTraceGuids 関数を呼び出して以前に登録されている必要があります。
重要
DLL またはドライバーによって作成されたすべての登録ハンドルは、DLL またはドライバーがアンロードされる前に登録解除する必要があります。 プロバイダーの登録が解除されていない場合、ETW がプロバイダーのコールバックを呼び出そうとしたときにクラッシュが発生します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | evntrace.h |
Library | Advapi32.lib |
[DLL] | Advapi32.dll |