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

Article
03/13/2024

La méthode LowHealth permet à l’extension de classe Helper de case activée si le composant en cours de diagnostic est sain.

Syntaxe

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

Paramètres

[in] pwszInstanceDescription

Pointeur vers une chaîne terminée par null contenant la description conviviale des informations en cours de diagnostic. Par exemple, si une classe devait diagnostiquer un problème de connectivité avec une adresse IP, le paramètre pwszInstanceDescription contiendrait le nom d’hôte.

[out] ppwszDescription

Pointeur vers une chaîne terminée par null contenant la description du problème détecté si le composant est jugé défectueux.

[out] pDeferredTime

Pointeur vers le délai, en secondes, à reporter si le diagnostic ne peut pas être démarré immédiatement. Il est utilisé lorsque le paramètre pStatus est défini sur DS_DEFERRED.

[out] pStatus

Pointeur vers le DIAGNOSIS_STATUS retourné par le diagnostic.

Valeur retournée

Code de retour	Description
S_OK	L’opération a réussi.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour effectuer cette opération.
E_INVALIDARG	Un ou plusieurs paramètres n’ont pas été fournis correctement.
E_ACCESSDENIED	L’appelant ne dispose pas des privilèges suffisants pour effectuer l’opération de diagnostic ou de réparation.
E_ABORT	L’opération de diagnostic ou de réparation a été annulée.

Les extensions de classe d’assistance peuvent retourner des HRESULTS spécifiques aux échecs rencontrés dans la fonction.

Remarques

La méthode LowHealth est requise lors de la création d’une extension de classe d’assistance.

Si LowHealth retourne DS_CONFIRMED, ppwszDescription contiendra également une description conviviale du résultat du diagnostic. Le paramètre out pDeferredTime contient le nombre de secondes pendant lesquelles ce diagnostic doit être différé si pStatus retourne DS_DEFERRED.

Lorsque LowHealth est confirmé, il peut également éventuellement générer des hypothèses dans la méthode GetLowerHypotheses pour d’autres classes d’assistance si le problème peut être dû à d’autres composants. S’il n’est pas confirmé, NDF peut diagnostiquer davantage le problème en appelant HighUtilization.

LowHealth peut également retourner DS_INDETERMINATE si elle n’est pas en mesure de diagnostiquer le problème, mais ne peut pas confirmer que le composant est sain. Dans ce cas, NDF le traitera comme DS_CONFIRMED si aucune des autres hypothèses n’est confirmée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ndhelper.h

Voir aussi

INetDiagHelper

Partager via