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

Article
02/29/2024

La méthode HighUtilization permet à l’extension de classe d’assistance de case activée si le composant correspondant est fortement utilisé.

Syntaxe

HRESULT HighUtilization(
  [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 résultat du diagnostic d’utilisation élevée.

[out] pDeferredTime

Pointeur vers le délai, en secondes, à différer 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_NOTIMPL	Cette méthode facultative n’est pas implémentée.
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

Cette méthode n’est pas requise lors de la création d’une extension de classe d’assistance.

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