Поделиться через

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

  • Статья

Функция NdfRepairIncident восстанавливает инцидент без отображения пользовательского интерфейса.

Синтаксис

void NdfRepairIncident(
  [in] NDFHANDLE    Handle,
  [in] RepairInfoEx *RepairEx,
       DWORD        dwWait
);

Параметры

[in] Handle

Тип: NDFHANDLE

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

[in] RepairEx

Тип: RepairInfoEx*

Структура (полученная из NdfDiagnoseIncident), которая указывает на конкретное исправление, которое необходимо выполнить.

Память, выделенная для этих структур, должна быть освобождена позже. Пример этого см. в разделе Примеры диагностики сети Microsoft Windows.

dwWait

Тип: DWORD

Продолжительность ожидания (в миллисекундах) перед завершением диагностической процедуры. Параметру INFINITE можно передать, если время ожидания не требуется.

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

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

Код возврата Описание
S_OK
 Восстановление выполнено успешно.
NDF_E_VALIDATION
 Восстановление выполнено успешно, но проверка NDF по-прежнему обнаружила проблему с подключением. Если это значение возвращается, сеанс должен быть закрыт путем вызова NdfCloseIncident и должен быть создан еще один сеанс для продолжения диагностики.
E_HANDLE
 Недопустимый дескриптор инцидента NDF.
WAIT_TIMEOUT
 Операция восстановления завершилась, так как она заняла больше времени ожидания, чем время ожидания, указанное в dwWait.
 

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

Комментарии

NdfRepairIncident можно вызывать только при использовании NdfDiagnoseIncident для диагностика. Обычно это происходит в сценариях, где пользовательский интерфейс не отображается или когда не используется стандартный интерфейс Windows (как в Случае с Media Center и внедренными приложениями). NdfRepairIncident не следует вызывать при использовании NdfExecuteDiagnosis .

Перед использованием этого API приложение должно вызвать функцию создания инцидентов, например NdfCreateWebIncident, чтобы начать процесс диагностика NDF. Затем приложение вызывает NdfDiagnoseIncident для диагностики проблемы. Если процесс диагностика определяет некоторые возможные исправления, приложение может вызвать NdfRepairIncident, чтобы устранить проблему без отображения пользовательского интерфейса. При необходимости NdfCancelIncident можно вызвать из отдельного потока, если приложение хочет отменить текущий вызов NdfRepairIncident . Наконец, приложение вызывает NdfCloseIncident.

Требования

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

См. также раздел

NdfDiagnoseIncident

RepairInfoEx