Método INetDiagHelper::LowHealth (ndhelper.h)

El método LowHealth permite que la extensión de clase auxiliar compruebe si el componente que se está diagnosticando es correcto.

Sintaxis

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

Parámetros

[in] pwszInstanceDescription

Puntero a una cadena terminada en null que contiene la descripción fácil de usar de la información que se está diagnosticando. Por ejemplo, si una clase fuera a diagnosticar un problema de conectividad con una dirección IP, el parámetro pwszInstanceDescription contendría el nombre de host.

[out] ppwszDescription

Puntero a una cadena terminada en null que contiene la descripción del problema encontrado si se encuentra que el componente es incorrecto.

[out] pDeferredTime

Puntero al tiempo, en segundos, que se va a aplazar si el diagnóstico no se puede iniciar inmediatamente. Se usa cuando el parámetro pStatus se establece en DS_DEFERRED.

[out] pStatus

Puntero al DIAGNOSIS_STATUS que se devuelve desde el diagnóstico.

Valor devuelto

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_OUTOFMEMORY	No hay suficiente memoria disponible para completar esta operación.
E_INVALIDARG	Uno o varios parámetros no se han proporcionado correctamente.
E_ACCESSDENIED	El autor de la llamada no tiene privilegios suficientes para realizar el diagnóstico o la operación de reparación.
E_ABORT	Se ha cancelado la operación de diagnóstico o reparación.

 

Las extensiones de clase auxiliar pueden devolver HRESULTS específicos de los errores detectados en la función.

Comentarios

El método LowHealth es necesario al compilar una extensión de clase auxiliar.

Si LowHealth devuelve DS_CONFIRMED, ppwszDescription también contendrá una descripción fácil de usar del resultado del diagnóstico. El parámetro out pDeferredTime contiene el número de segundos que debe aplazarse este diagnóstico si pStatus devuelve DS_DEFERRED.

Cuando se confirma LowHealth, también puede generar hipótesis opcionalmente en el método GetLowerHypotheses para otras clases auxiliares si el problema puede deberse a otros componentes. Si no se confirma, NDF puede diagnosticar aún más el problema llamando a HighUtilization.

LowHealth también puede devolver DS_INDETERMINATE si no puede diagnosticar el problema, pero no puede confirmar que el componente es correcto. En este caso, NDF lo tratará como DS_CONFIRMED si no se confirma ninguna de las otras hipótesis.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ndhelper.h

Consulte también

INetDiagHelper