PdhSetDefaultRealTimeDataSource-Funktion (pdh.h)

Gibt die Quelle der Echtzeitdaten an.

Syntax

PDH_FUNCTION PdhSetDefaultRealTimeDataSource(
  [in] DWORD dwDataSourceId
);

Parameter

[in] dwDataSourceId

Quelle der Leistungsdaten. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
DATA_SOURCE_REGISTRY	Die Datenquelle ist die Registrierungsschnittstelle. Dies ist die Standardoption.
DATA_SOURCE_WBEM	Die Datenquelle ist ein WMI-Anbieter.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden ist ein möglicher Wert aufgeführt.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Der Parameter ist ungültig.

Hinweise

Der Begriff Echtzeit , wie er in der Beschreibung dieser Funktion verwendet wird, impliziert nicht die Standardbedeutung des Begriffs Echtzeit. Stattdessen wird die Sammlung von Leistungsdaten aus einer Quelle beschrieben, die aktuelle Informationen bereitstellt (z. B. die Registrierung oder ein WMI-Anbieter), anstatt aus einer Protokolldatei.

Wenn Sie Echtzeitdaten aus WMI abfragen möchten, müssen Sie PdhSetDefaultRealTimeDataSource aufrufen, um die Standarddatenquelle in Echtzeit festzulegen. Sie müssen diese Funktion aufrufen, bevor Sie eine andere PDH-API-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pdh.h
Bibliothek	Pdh.lib
DLL	Pdh.dll

Weitere Informationen

PdhSelectDataSource