UnregisterTraceGuids 関数 (evntrace.h)

UnregisterTraceGuids 関数は、RegisterTraceGuids を使用して登録されたクラシック (Windows 2000 スタイル) ETW イベントトレースプロバイダーの登録を解除します。

構文

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE 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