EventUnregister 関数 (evntprov.h)

ETW イベント プロバイダーの登録を解除します。

コンポーネントによって登録されているすべてのイベント プロバイダーは、コンポーネントがアンロードされる前に登録解除する必要があります。 DLL がイベント プロバイダーを登録し、イベント プロバイダーの登録を解除せずにアンロードすると、プロセスがクラッシュする可能性があります。

構文

ULONG EVNTAPI EventUnregister(
  [in] REGHANDLE RegHandle
);

パラメーター

[in] RegHandle

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

戻り値

成功した場合 はERROR_SUCCESS を返します。

解説

EventRegister が失敗した場合は、0 値の RegHandle が返されます。 EventWriteEventUnregister などの ETW API は、値が 0 の RegHandle 値を安全に受け入れ、何も行わないとすぐに返されます。 呼び出し元は、EventWrite または EventUnregister を呼び出す前に、値が 0 の RegHandle をチェックする必要はありません。

要件

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

関連項目

EventRegister