INetDiagHelper::LowHealth-Methode (ndhelper.h)

Artikel
08/25/2023

Mit der LowHealth-Methode kann die Hilfsklassenerweiterung überprüfen, ob die zu diagnostizierende Komponente fehlerfrei ist.

Syntax

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

Parameter

[in] pwszInstanceDescription

Ein Zeiger auf eine NULL-Zeichenfolge mit der benutzerfreundlichen Beschreibung der zu diagnostizierenden Informationen. Wenn beispielsweise eine Klasse ein Konnektivitätsproblem mit einer IP-Adresse diagnostizieren würde, enthält der pwszInstanceDescription-Parameter den Hostnamen .

[out] ppwszDescription

Ein Zeiger auf eine NULL-Zeichenfolge, die die Beschreibung des Problems enthält, das gefunden wird, wenn die Komponente fehlerhaft ist.

[out] pDeferredTime

Ein Zeiger auf die Zeit in Sekunden, die zurückgestellt werden soll, wenn die Diagnose nicht sofort gestartet werden kann. Dies wird verwendet, wenn der pStatus-Parameter auf DS_DEFERRED festgelegt ist.

[out] pStatus

Ein Zeiger auf den DIAGNOSIS_STATUS , der von der Diagnose zurückgegeben wird.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
E_INVALIDARG	Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um den Diagnose- oder Reparaturvorgang auszuführen.
E_ABORT	Die Diagnose oder der Reparaturvorgang wurde abgebrochen.

Hilfsklassenerweiterungen geben möglicherweise HRESULTS zurück, die spezifisch für die In der Funktion aufgetretenen Fehler sind.

Hinweise

Die LowHealth-Methode ist beim Erstellen einer Hilfsklassenerweiterung erforderlich.

Wenn LowHealth DS_CONFIRMED zurückgibt, enthält ppwszDescription auch eine benutzerfreundliche Beschreibung des Diagnoseergebnisses. Der Out-Parameter pDeferredTime enthält die Anzahl der Sekunden, die diese Diagnose zurückgestellt werden muss, wenn pStatus DS_DEFERRED zurückgibt.

Wenn LowHealth bestätigt wird, kann es auch optional Hypothesen in der GetLowerHypotheses-Methode für andere Hilfsklassen generieren, wenn das Problem möglicherweise von anderen Komponenten verursacht wird. Wenn nicht bestätigt, kann NDF das Problem weiter diagnostizieren, indem HighUtilization aufgerufen wird.

LowHealth kann auch DS_INDETERMINATE zurückgeben, wenn das Problem nicht diagnostiziert werden kann, aber nicht bestätigen kann, dass die Komponente fehlerfrei ist. In diesem Fall behandelt NDF es als DS_CONFIRMED , wenn keine der anderen Hypothesen bestätigt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ndhelper.h

Weitere Informationen

INetDiagHelper

Freigeben über