NdfGetTraceFile function (ndfapi.h)

The NdfGetTraceFile function is used to retrieve the path containing an Event Trace Log (ETL) file that contains Event Tracing for Windows (ETW) events from a diagnostic session.

Syntax

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

Parameters

[in] Handle

Type: NDFHANDLE

Handle to a Network Diagnostics Framework incident. This handle should match the handle of an existing incident.

[out] TraceFileLocation

Type: LPCWSTR*

The location of the trace file.

Return value

Type: HRESULT

Possible return values include, but are not limited to, the following.

Any result other than S_OK should be interpreted as an error.

Remarks

This function cannot be called on an incident which has already been closed.

ETL files contain information such as which components were diagnosed, component configuration information, and diagnosis results. For more information about ETL files, see Network Tracing in Windows 7.

Requirements