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

Метод INetDiagHelper::LowHealth (ndhelper.h)

  • Статья

Метод LowHealth позволяет расширению вспомогательного класса проверка работоспособности диагностируемого компонента.

Синтаксис

HRESULT LowHealth(
  [in]  LPCWSTR          pwszInstanceDescription,
  [out] LPWSTR           *ppwszDescription,
  [out] long             *pDeferredTime,
  [out] DIAGNOSIS_STATUS *pStatus
);

Параметры

[in] pwszInstanceDescription

Указатель на строку со значением NULL, содержащую понятное описание диагностируемой информации. Например, если класс диагностирует проблему с подключением с IP-адресом, параметр pwszInstanceDescription будет содержать имя узла.

[out] ppwszDescription

Указатель на строку, завершающуюся значением NULL, содержащую описание проблемы, обнаруженной при обнаружении компонента как неработоспособного.

[out] pDeferredTime

Указатель на время (в секундах), отложенное, если диагностика не может быть запущена немедленно. Используется, если параметру pStatus присвоено значение DS_DEFERRED.

[out] pStatus

Указатель на DIAGNOSIS_STATUS , возвращаемый из диагноза.

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

Код возврата Описание
S_OK
 Операция успешно выполнена.
E_OUTOFMEMORY
 Для выполнения этой операции недостаточно памяти.
E_INVALIDARG
 Один или несколько параметров указаны неправильно.
E_ACCESSDENIED
 Вызывающий объект не имеет достаточных привилегий для выполнения операции диагностики или восстановления.
E_ABORT
 Операция диагностики или восстановления отменена.
 

Расширения вспомогательного класса могут возвращать HRESULTS, относящиеся к сбоям, возникшим в функции.

Комментарии

Метод LowHealth является обязательным при создании расширения вспомогательного класса.

Если LowHealth возвращает DS_CONFIRMED, ppwszDescription также будет содержать понятное описание результата диагностики. Параметр out pDeferredTime содержит количество секунд, в течение которых эта диагностика должна быть отложена, если pStatus возвращает DS_DEFERRED.

При подтверждении LowHealth он также может при необходимости генерировать гипотезы в методе GetLowerHypotheses для других вспомогательных классов, если проблема может быть вызвана другими компонентами. Если не подтвердится, NDF может дополнительно диагностировать проблему, вызвав HighUtilization.

LowHealth также может вернуть DS_INDETERMINATE , если не удается диагностировать проблему, но не может подтвердить работоспособность компонента. В этом случае NDF будет рассматривать его как DS_CONFIRMED если ни одна из других гипотез не подтвердится.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header ndhelper.h

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

INetDiagHelper