NdfGetTraceFile-Funktion (ndfapi.h)

Artikel
02/29/2024

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

Freigeben über