NdfGetTraceFile-Funktion (ndfapi.h)

Die NdfGetTraceFile-Funktion wird verwendet, um den Pfad abzurufen, der eine ETL-Datei (Event Trace Log) enthält, die ETW-Ereignisse (Event Tracing for Windows) enthält.

Syntax

void NdfGetTraceFile(
  [in]  NDFHANDLE Handle,
  [out] LPCWSTR   *TraceFileLocation
);

Parameter

[in] Handle

Typ: NDFHANDLE

Behandeln eines Netzwerkdiagnoseframework-Incidents. Dieses Handle sollte mit dem Handle eines vorhandenen Incidents übereinstimmen.

[out] TraceFileLocation

Typ: LPCWSTR*

Der Speicherort der Ablaufverfolgungsdatei.

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. die folgenden:

Jedes andere Ergebnis als S_OK sollte als Fehler interpretiert werden.

Hinweise

Diese Funktion kann nicht für einen Incident aufgerufen werden, der bereits geschlossen wurde.

ETL-Dateien enthalten Informationen, z. B. welche Komponenten diagnostiziert wurden, Informationen zur Komponentenkonfiguration und Diagnoseergebnisse. Weitere Informationen zu ETL-Dateien finden Sie unter Netzwerkablaufverfolgung in Windows 7.

Anforderungen