Функция NdfGetTraceFile (ndfapi.h)

Функция NdfGetTraceFile используется для получения пути, содержащего файл журнала трассировки событий (ETL), который содержит события трассировки событий Windows (ETW) из диагностического сеанса.

Синтаксис

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

Параметры

[in] Handle

Тип: NDFHANDLE

Обработка инцидента платформы диагностики сети. Этот дескриптор должен совпадать с дескриптором существующего инцидента.

[out] TraceFileLocation

Тип: LPCWSTR*

Расположение файла трассировки.

Возвращаемое значение

Тип: HRESULT

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Операция успешно выполнена.

 

Любой результат, отличный от S_OK, следует интерпретировать как ошибку.

Комментарии

Эта функция не может быть вызвана для инцидента, который уже был закрыт.

Файлы ETL содержат такие сведения, как компоненты, которые были диагностированы, сведения о конфигурации компонентов и результаты диагностики. Дополнительные сведения о ETL-файлах см. в статье Трассировка сети в Windows 7.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	ndfapi.h
Библиотека	Ndfapi.lib
DLL	Ndfapi.dll