PdhGetDataSourceTimeRangeA-Funktion (pdh.h)

Artikel
11/20/2024

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

Um Handles für Datenquellen zu verwenden, verwenden Sie die PdhGetDataSourceTimeRangeH--Funktion.

Syntax

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parameter

[in] szDataSource

Null-beendete Zeichenfolge, die den Namen einer Protokolldatei angibt, aus der die Zeitbereichsinformationen abgerufen werden.

[out] pdwNumEntries

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

[out] pInfo

Eine PDH_TIME_INFO Struktur, die den Zeitraum empfängt.

[in] pdwBufferSize

Größe der PDH_TIME_INFO Struktur in Byte.

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 sind mögliche Werte aufgeführt.

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

Bemerkungen

Anmerkung

Der pdh.h-Header definiert PdhGetDataSourceTimeRange als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	pdh.h
Library	Pdh.lib
DLL-	Pdh.dll

Siehe auch

PdhGetDataSourceTimeRangeH-

PdhSetQueryTimeRange-

Freigeben über