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 |
|---|---|
|
Die Datenquelle ist die Registrierungsschnittstelle. Dies ist die Standardoption. |
|
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 |
|---|---|
|
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 |