PerfStartProvider-Funktion (perflib.h)

Registriert den Anbieter.

Syntax

ULONG PerfStartProvider(
  [in]           LPGUID         ProviderGuid,
  [in, optional] PERFLIBREQUEST ControlCallback,
  [out]          HANDLE         *phProvider
);

Parameter

[in] ProviderGuid

GUID, die den Anbieter eindeutig identifiziert. Das providerGuid-Attribut des Anbieterelements gibt die GUID an.

[in, optional] ControlCallback

ControlCallback-Funktion , die PERFLIB aufruft, um Sie über Consumeranforderungen zu benachrichtigen, z. B. eine Anforderung zum Hinzufügen oder Entfernen von Leistungsindikatoren aus der Abfrage. Dieser Parameter wird festgelegt, wenn das Rückrufattribut des Counters-Elements "custom" ist. andernfalls NULL.

[out] phProvider

Handle an den Anbieter. Sie müssen PerfStopProvider aufrufen, um ressourcen freizugeben, die dem Handle zugeordnet sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Die CounterInitialize-Funktion ruft diese Funktion auf. Rufen Sie diese Funktion nicht direkt auf.

Windows Vista: Die PerfAutoInitialize-Funktion ruft diese Funktion auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	perflib.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

PerfStopProvider