PdhGetLogFileSize-Funktion (pdh.h)

  • Artikel

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