Share via


TRACELOGGING_DECLARE_PROVIDER マクロ (traceloggingprovider.h)

トレース ログ プロバイダーのハンドルを前方宣言します。

構文

void TRACELOGGING_DECLARE_PROVIDER(
  [in]  handleVariable
);

パラメーター

[in] handleVariable

前方宣言するハンドル名。 これは、.c または TRACELOGGING_DEFINE_PROVIDER を使用して.cpp ファイルで定義されているハンドル 名前である必要があります。

戻り値

なし

解説

必要に応じてこのマクロを使用して、トレース ログ プロバイダー ハンドル (コンポーネントのヘッダー ファイル内など) を前方宣言します。 このマクロは、プロバイダー ハンドルにストレージを割り当てません。 プロバイダーを使用するには、 TRACELOGGING_DEFINE_PROVIDER を使用してハンドルを定義し、 TraceLoggingRegister を使用して登録する必要があります。

のような TRACELOGGING_DECLARE_PROVIDER(MyProviderHandle) 呼び出しは、次のようなコードに似ていると考えることができます。

extern "C" const TraceLoggingHProvider MyProviderHandle;

注意

によって TRACELOGGING_DECLARE_PROVIDER 宣言されたプロバイダー ハンドルには、モジュール スコープがあります。 EXE、DLL、または SYS ファイル内で必要に応じて使用できますが、同じプロセスで他の DLL と共有しないでください。 各 EXE、DLL、または SYS ファイルは、独自のプロバイダー ハンドルを定義し、独自の Register と Unregister を実行する必要があります。

要件

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

こちらもご覧ください

TRACELOGGING_DEFINE_PROVIDER

TraceLoggingWrite

トレース ログ ラッパー マクロ