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
 1 つ以上のパラメーターが正しく指定されていません。
E_ACCESSDENIED
 呼び出し元には、診断または修復操作を実行するための十分な特権がありません。
E_ABORT
 診断または修復操作が取り消されました。
 

ヘルパー クラス拡張機能は、関数で発生したエラーに固有の HRESULTS を返す場合があります。

注釈

ヘルパー クラス拡張機能を構築する場合は、LowHealth メソッドが必要です。

LowHealth が DS_CONFIRMEDを返す場合、 ppwszDescription には診断結果のわかりやすい説明も含まれます。 out パラメーター pDeferredTime には、pStatus がDS_DEFERREDを返す場合に、この診断を延期する必要がある秒数が含 まれています。

LowHealth が確認されると、必要に応じて、他のコンポーネントによって問題が発生する可能性がある場合は、他のヘルパー クラスの GetLowerHypotheses メソッドで仮説を生成することもできます。 確認されていない場合、NDF は HighUtilization を呼び出すことによって問題をさらに診断する可能性があります。

LowHealth は、問題を診断できないが、コンポーネントが正常であることを確認できない場合は、 DS_INDETERMINATE を返す場合もあります。 この場合、NDF は、他の仮説が確認されていない場合は 、DS_CONFIRMED として扱います。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ndhelper.h

こちらもご覧ください

INetDiagHelper