Freigeben über


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:

Rückgabecode BESCHREIBUNG
S_OK
Der Vorgang wurde erfolgreich ausgeführt.
 

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ndfapi.h
Bibliothek Ndfapi.lib
DLL Ndfapi.dll