INetDiagHelper::Metode LowHealth (ndhelper.h)

Artikel
02/29/2024

Metode LowHealth memungkinkan Ekstensi Kelas Pembantu untuk memeriksa apakah komponen yang didiagnosis sehat.

Sintaks

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

Parameter

[in] pwszInstanceDescription

Penunjuk ke string yang dihentikan null yang berisi deskripsi informasi yang mudah digunakan yang didiagnosis. Misalnya, jika kelas mendiagnosis masalah konektivitas dengan alamat IP, parameter pwszInstanceDescription akan berisi nama host.

[out] ppwszDescription

Penunjuk ke string yang dihentikan null yang berisi deskripsi masalah yang ditemukan jika komponen ditemukan tidak sehat.

[out] pDeferredTime

Pointer ke waktu, dalam detik, untuk ditangguhkan jika diagnosis tidak dapat segera dimulai. Ini digunakan ketika parameter pStatus diatur ke DS_DEFERRED.

[out] pStatus

Pointer ke DIAGNOSIS_STATUS yang dikembalikan dari diagnosis.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi ini.
E_INVALIDARG	Satu atau beberapa parameter belum disediakan dengan benar.
E_ACCESSDENIED	Pemanggil tidak memiliki hak istimewa yang memadai untuk melakukan operasi diagnosis atau perbaikan.
E_ABORT	Operasi diagnosis atau perbaikan telah dibatalkan.

Ekstensi Kelas Pembantu dapat mengembalikan HRESULTS yang khusus untuk kegagalan yang ditemui dalam fungsi.

Keterangan

Metode LowHealth diperlukan saat membangun Ekstensi Kelas Pembantu.

Jika LowHealth mengembalikan DS_CONFIRMED, ppwszDescription juga akan berisi deskripsi hasil diagnosis yang mudah digunakan. Parameter keluar pDeferredTime berisi jumlah detik diagnosis ini perlu ditangguhkan jika pStatus mengembalikan DS_DEFERRED.

Ketika LowHealth dikonfirmasi, ini juga dapat secara opsional menghasilkan hipotesis dalam metode GetLowerHypotheses untuk kelas pembantu lain jika masalahnya mungkin disebabkan oleh komponen lain. Jika tidak dikonfirmasi, NDF dapat mendiagnosis masalah lebih lanjut dengan memanggil HighUtilization.

LowHealth juga dapat mengembalikan DS_INDETERMINATE jika tidak dapat mendiagnosis masalah, tetapi tidak dapat mengonfirmasi bahwa komponen sehat. Dalam hal ini, NDF akan memperlakukannya sebagai DS_CONFIRMED jika tidak ada hipotesis lain yang dikonfirmasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	ndhelper.h

Lihat juga

INetDiagHelper

Bagikan melalui