PdhGetDataSourceTimeRangeH-Funktion (pdh.h)

Artikel
03/01/2024

Bestimmt den Zeitbereich, die Anzahl der Einträge und ggf. die Größe des Puffers, der die Leistungsdaten aus der angegebenen Eingabequelle enthält.

Diese Funktion ist identisch mit der PdhGetDataSourceTimeRange-Funktion , mit der Ausnahme, dass sie die Verwendung von Handles für Datenquellen unterstützt.

Syntax

PDH_FUNCTION PdhGetDataSourceTimeRangeH(
  [in]  PDH_HLOG       hDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parameter

[in] hDataSource

Handle an eine Datenquelle, die von der PdhBindInputDataSource-Funktion zurückgegeben wird.

[out] pdwNumEntries

Anzahl der Strukturen im pInfo-Puffer . Diese Funktion sammelt Informationen nur für einen Zeitbereich, sodass der Wert in der Regel 1 oder null ist, wenn ein Fehler aufgetreten ist.

[out] pInfo

Eine PDH_TIME_INFO-Struktur , die den Zeitbereich empfängt. Die Informationen umfassen alle gebundenen Protokolldateien.

[in] pdwBufferSize

Größe der PDH_TIME_INFO-Struktur in Bytes.

Rückgabewert

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

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

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Ein Parameter ist ungültig oder falsch formatiert.
PDH_INVALID_HANDLE	Das Zählerhandle ist ungültig.
PDH_DATA_SOURCE_IS_REAL_TIME	Die aktuelle Datenquelle ist eine Echtzeitdatenquelle.

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

PdhBindInputDataSource