Freigeben über


PdhGetDataSourceTimeRangeH-Funktion (pdh.h)

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