PdhReadRawLogRecord-Funktion (pdh.h)

  • Artikel

Liest die Informationen in der angegebenen binären Ablaufverfolgungsprotokolldatei.

Syntax

PDH_FUNCTION PdhReadRawLogRecord(
  [in]  PDH_HLOG            hLog,
  [in]  FILETIME            ftRecord,
  [out] PPDH_RAW_LOG_RECORD pRawLogRecord,
  [in]  LPDWORD             pdwBufferLength
);

Parameter

[in] hLog

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

[in] ftRecord

Zeitstempel des zu lesenden Datensatzes. Wenn der Zeitstempel nicht mit einem Datensatz in der Protokolldatei übereinstimmt, gibt die Funktion den Datensatz zurück, der einen Zeitstempel aufweist, der dem angegebenen Zeitstempel am nächsten ist (aber nicht größer als).

[out] pRawLogRecord

Vom Aufrufer zugewiesener Puffer, der eine PDH_RAW_LOG_RECORD-Struktur empfängt; Die -Struktur enthält die Protokolldateidatensatzinformationen. Legen Sie auf NULL fest, wenn pdwBufferLength null ist.

[in] pdwBufferLength

Größe des pRawLogRecord-Puffers in TCHARs. Wenn null bei der Eingabe, gibt die Funktion PDH_MORE_DATA zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn der Puffer größer als die erforderliche Größe ist, legt die Funktion diesen Parameter auf die tatsächliche Größe des verwendeten Puffers fest. Wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen.

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 nicht gültig. Bei einigen Releases kann dieser Fehler beispielsweise angezeigt werden, wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist.
PDH_MORE_DATA
 Der Puffer pRawLogRecord ist zu klein, um die Pfadelemente zu enthalten. Dieser Rückgabewert wird erwartet, wenn pdwBufferLength bei der Eingabe null ist. Wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen.
PDH_MEMORY_ALLOCATION_FAILURE
 Speicher kann nicht zugeordnet werden, um die Funktion abzuschließen.

Hinweise

Sie sollten diese Funktion zweimal aufrufen, das erste Mal, um die erforderliche Puffergröße abzurufen (legen Sie pRawLogRecord auf NULL und pdwBufferLength auf 0 fest), und beim zweiten Mal, um die Daten abzurufen.

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

PDH_RAW_LOG_RECORD

PdhCollectQueryData

PdhFormatFromRawValue