PdhGetDataSourceTimeRangeA-Funktion (pdh.h)

  • Artikel

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-terminierte 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 Zeitbereich, sodass der Wert in der Regel 1 oder null ist, wenn ein Fehler auftritt.

[out] pInfo

Eine PDH_TIME_INFO-Struktur , die den Zeitbereich empfängt.

[in] pdwBufferSize

Größe der PDH_TIME_INFO-Struktur in Bytes.

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. Die folgenden Werte sind möglich.

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.

Hinweise

Hinweis

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
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

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange