共用方式為

INetDiagHelper：：LowHealth 方法 (ndhelper.h)

  • 發行項

LowHealth 方法可讓協助程式類別延伸模組檢查所診斷的元件是否狀況良好。

語法

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

參數

[in] pwszInstanceDescription

Null 終止字串的指標，其中包含所診斷資訊的用戶易記描述。 例如，如果類別是診斷IP位址的連線問題， pwszInstanceDescription 參數會包含主機名。

[out] ppwszDescription

Null 終止字串的指標，其中包含如果找到元件狀況不良時所發現問題的描述。

[out] pDeferredTime

如果無法立即啟動診斷，則會延遲時間的指標，以秒為單位。 當 pStatus 參數設定為 DS_DEFERRED時，就會使用此 參數。

[out] pStatus

診斷傳回 之DIAGNOSIS_STATUS 指標。

傳回值

傳回碼 描述
S_OK
 作業成功。
E_OUTOFMEMORY
 記憶體不足，無法完成這項作業。
E_INVALIDARG
 尚未正確提供一或多個參數。
E_ACCESSDENIED
 呼叫端沒有足夠的許可權來執行診斷或修復作業。
E_ABORT
 診斷或修復作業已取消。
 

協助程式類別延伸模組可能會傳回函式中發生失敗的特定 HRESULTS。

備註

建置 Helper 類別延伸模組時，需要 LowHealth 方法。

如果 LowHealth 傳回DS_CONFIRMED，ppwszDescription 也會包含診斷結果的用戶易記描述。 如果 pStatus 傳回DS_DEFERRED，out 參數 pDeferredTime 包含此診斷需要延遲的秒數。

確認 LowHealth 時，如果問題可能是由其他元件所造成，也可能選擇性地在 GetLowerHypotheses 方法中產生其他協助程式類別的假設。 如果未確認，NDF 可能會藉由呼叫 HighUtilization 進一步診斷問題。

LowHealth 也可以在無法診斷問題時傳回 DS_INDETERMINATE ，但無法確認元件狀況良好。 在此情況下，如果未確認其他假設，NDF 會將它視為 DS_CONFIRMED 。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 ndhelper.h

另請參閱

INetDiagHelper