INetDiagHelper

INetDiagHelper インターフェイスは、ネットワーク関連の問題の診断および解決に関連する情報を取得し提供するメソッドを提供します。

Initialize メソッドは、仮説 (hypothesis) から Helper Class Extension へ属性を渡します。ヘルパークラスは、主要な診断関数で使用するためにこれらのパラメーターを保存する必要があります。このメソッドは、いずれの診断関数よりも前に呼び出す必要があります。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

Initialize メソッドは Helper Class Extension の構築時に必須です。

Helper Class Extension のインスタンスが見積もり (estimate) を提供できるようにします。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

GetDiagnosticsInfo メソッドは Helper Class Extension の構築時に必須です。

Helper Class Extension のキー属性を取得します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

診断対象のコンポーネントが正常かどうかを確認します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

LowHealth メソッドは Helper Class Extension の構築時に必須です。

LowHealth が DS_CONFIRMED を返す場合、ppwszDescription には診断結果のユーザーフレンドリーな説明も格納されます。出力パラメーター pDeferredTime には、pStatus が DS_DEFERRED を返す場合に、この診断を延期する必要がある秒数が格納されます。

LowHealth が確定した場合、問題が他のコンポーネントに起因する可能性があるときは、GetLowerHypotheses メソッドで他のヘルパークラス向けの仮説を任意に生成することもできます。確定しなかった場合、NDF は HighUtilization を呼び出して問題をさらに診断する場合があります。

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

対応するコンポーネントの使用率が高いかどうかを確認します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

ローカルコンポーネントにおける正常性低下 (low health) の考えられる原因についての仮説を生成します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

Helper Class Extension に仮説の生成を要求します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

高使用率の考えられる原因についての仮説を生成します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

上流のネットワークコンポーネントにおける高使用率の考えられる原因についての仮説を生成します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

入力パラメーターで指定された修復を実行します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

修復が正常に完了した後に NDF によって呼び出されます。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

このメソッドは、検証を妨げる障害が発生した場合にのみエラーコードを返します。コンポーネントが依然として正常でないことを伝えるには、必要に応じて pStatus パラメーターを使用するのが想定される方法です。問題が解決されたことを示すには DS_REJECTED を使用します。

指定された問題の種類について、Helper Class Extension が保持する修復情報を取得します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

Helper Class Extension インスタンスの有効期間 (lifetime) を取得します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

有効期間のデータは、問題インスタンスの時間的範囲を限定するために使用されます。これは、トレースやログ記録のような履歴に基づく診断を行う場合に特に有用で、指定した時間間隔中に発生したイベントへ診断範囲を絞り込むのに利用できます。

たとえば、Windows Filtering Platform (WFP) のヘルパークラスは、トレースログを確認してどのフィルターがパケットをブロックしたかを判定するために有効期間を使用します。既定では、ヘルパークラスインスタンスの有効期間は、依存先のヘルパークラスインスタンスの有効期間を継承します。

Helper Class Extension は、その期間内に発生したイベントに診断を限定できます。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

診断および修復の操作のキャッシュされた結果が期限切れとなる時刻を指定します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

既定の動作は現在時刻を返すことであり、その場合、結果はキャッシュされません。キャッシュ時間を設定すると、キャッシュ時間が期限切れになるまで NDF が拡張機能に問題の再診断を要求しなくなるため、診断の効率を高めることができます。

FILETIME 構造体は、1601 年 1 月 1 日 (UTC) からの 100 ナノ秒間隔の数を表す 64 ビット値です。

ヘルパークラス拡張機能が診断した問題に関する追加情報を取得します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

このメソッドは Helper Class Extension の構築時には必須ではありません。

診断および修復の過程で、ヘルパークラスは NDF による診断の処理を改善する属性を任意に NDF へ返すことができます。NDF へ返すことができる定義済みの属性は次のとおりです。

進行中の診断または修復を取り消します。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

Cancel メソッドは Helper Class Extension の構築時に必須です。

診断または修復の操作の後に、Helper Class Extension がリソースをクリーンアップできるようにします。

Helper Class Extension は、関数内で発生した障害に固有の HRESULT を返す場合があります。

Cleanup メソッドは Helper Class Extension の構築時に必須です。