TRACELOGGING_DECLARE_PROVIDER Makro (traceloggingprovider.h)

Forward-deklariert ein Handle für einen TraceLogging-Anbieter.

Syntax

void TRACELOGGING_DECLARE_PROVIDER(
  [in]  handleVariable
);

Parameter

[in] handleVariable

Der Handlename, der weitergeleitet werden soll. Dies sollte der Name eines Handles sein, das in einer C- oder .cpp-Datei mit TRACELOGGING_DEFINE_PROVIDER definiert wurde.

Rückgabewert

Keine

Bemerkungen

Verwenden Sie dieses Makro nach Bedarf, um das TraceLogging-Anbieterhandle weiterzudeklarieren, z. B. in einer Headerdatei Ihrer Komponente. Dieses Makro weist keinen Speicher für das Anbieterhandle zu. Um den Anbieter zu verwenden, müssen Sie TRACELOGGING_DEFINE_PROVIDER verwenden, um das Handle und TraceLoggingRegister zu definieren, um ihn zu registrieren.

Ein Aufruf wie TRACELOGGING_DECLARE_PROVIDER(MyProviderHandle) kann man sich als ähnlich wie Code wie vordenken:

extern "C" const TraceLoggingHProvider MyProviderHandle;

Hinweis

Das von deklarierte TRACELOGGING_DECLARE_PROVIDER Anbieterhandle verfügt über Modulbereich. Sie kann nach Bedarf in der EXE-, DLL- oder SYS-Datei verwendet werden, sollte aber nicht für andere DLLs im gleichen Prozess freigegeben werden. Jede EXE-, DLL- oder SYS-Datei sollte ein eigenes Anbieterhandle definieren und ihr eigenes Registrieren und Aufheben der Registrierung ausführen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile traceloggingprovider.h

Weitere Informationen

TRACELOGGING_DEFINE_PROVIDER

TraceLoggingWrite

TraceLogging-Wrappermakros