Metodo INetDiagHelper::LowHealth (ndhelper.h)

Articolo
08/25/2023

Il metodo LowHealth consente all'estensione della classe Helper di verificare se il componente da diagnosticare è integro.

Sintassi

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

Parametri

[in] pwszInstanceDescription

Puntatore a una stringa con terminazione null contenente la descrizione descrittiva delle informazioni da diagnosticare. Ad esempio, se una classe doveva diagnosticare un problema di connettività con un indirizzo IP, il parametro pwszInstanceDescription conterrà il nome host.

[out] ppwszDescription

Puntatore a una stringa con terminazione null contenente la descrizione del problema trovata se il componente non è integro.

[out] pDeferredTime

Puntatore al tempo, in secondi, da rinviare se la diagnosi non può essere avviata immediatamente. Viene usato quando il parametro pStatus è impostato su DS_DEFERRED.

[out] pStatus

Puntatore alla DIAGNOSIS_STATUS restituita dalla diagnosi.

Valore restituito

Codice restituito	Descrizione
S_OK	Operazione completata.
E_OUTOFMEMORY	Non è disponibile memoria sufficiente per completare questa operazione.
E_INVALIDARG	Uno o più parametri non sono stati forniti correttamente.
E_ACCESSDENIED	Il chiamante non dispone di privilegi sufficienti per eseguire la diagnosi o l'operazione di riparazione.
E_ABORT	La diagnosi o l'operazione di riparazione è stata annullata.

Le estensioni della classe helper possono restituire HRESULTS specifiche degli errori riscontrati nella funzione.

Commenti

Il metodo LowHealth è necessario quando si compila un'estensione della classe Helper.

Se LowHealth restituisce DS_CONFIRMED, ppwszDescription conterrà anche una descrizione descrittiva del risultato della diagnosi. Il parametro out pDeferredTime contiene il numero di secondi che questa diagnosi deve essere posticipata se pStatus restituisce DS_DEFERRED.

Quando LowHealth viene confermato, può anche generare ipotesi nel metodo GetLowerHypotheses per altre classi helper se il problema potrebbe essere causato da altri componenti. Se non viene confermato, NDF può diagnosticare ulteriormente il problema chiamando HighUtilization.

LowHealth può anche restituire DS_INDETERMINATE se non è in grado di diagnosticare il problema, ma non può confermare che il componente sia integro. In questo caso, NDF lo considera come DS_CONFIRMED se nessuna delle altre ipotesi viene confermata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ndhelper.h

Vedi anche

INetDiagHelper