PdhGetLogFileSize-Funktion (pdh.h)

Artikel
03/01/2024

Gibt die Größe der angegebenen Protokolldatei zurück.

Syntax

PDH_FUNCTION PdhGetLogFileSize(
  [in]  PDH_HLOG hLog,
  [out] LONGLONG *llSize
);

Parameter

[in] hLog

Handle für die Protokolldatei. Die Funktion PdhOpenLog oder PdhBindInputDataSource gibt dieses Handle zurück.

[out] llSize

Größe der Protokolldatei 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. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
PDH_LOG_FILE_OPEN_ERROR	Fehler beim Versuch, die Protokolldatei zu öffnen.
PDH_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Wenn das Protokolldateihandle auf mehrere gebundene Protokolldateien verweist, entspricht die Größe der Summe aller Protokolldateien. Wenn es sich bei der Protokolldatei um eine SQL-Protokolldatei handelt, entspricht der parameter llSize der Anzahl der Datensätze in der Protokolldatei.

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

PdhOpenLog

Freigeben über