NdfRepairIncident 関数 (ndfapi.h)

  • [アーティクル]

NdfRepairIncident 関数は、ユーザー インターフェイスを表示せずにインシデントを修復します。

構文

void NdfRepairIncident(
  [in] NDFHANDLE    Handle,
  [in] RepairInfoEx *RepairEx,
       DWORD        dwWait
);

パラメーター

[in] Handle

型: NDFHANDLE

ネットワーク診断フレームワーク インシデントを処理します。 このハンドルは、 NdfDiagnoseIncident に渡されるハンドルと一致する必要があります。

[in] RepairEx

種類: RepairInfoEx*

実行する特定の修復を示す構造体 ( NdfDiagnoseIncident から取得)。

これらの構造体に割り当てられたメモリは、後で解放する必要があります。 これを行う方法の例については、「Microsoft Windows ネットワーク診断サンプル」を参照してください。

dwWait

型: DWORD

診断ルーチンを終了するまでの待機時間 (ミリ秒単位)。 タイムアウトが必要ない場合は、このパラメーターに INFINITE を渡すことができます。

戻り値

可能な戻り値は次のとおりですが、これらに限定されません。

リターン コード 説明
S_OK
 修復に成功しました。
NDF_E_VALIDATION
 修復は正常に実行されましたが、NDF 検証でも接続の問題が見つかりました。 この値が返された場合は、 NdfCloseIncident を呼び出してセッションを閉じ、診断を続行するために別のセッションを作成する必要があります。
E_HANDLE
 NDF インシデント ハンドルが無効です。
WAIT_TIMEOUT
 dwWait で指定されたタイムアウトより長くかかったため、修復操作が終了しました。
 

修復の実行に失敗した場合は、その他のエラー コードが返されます。 その場合、クライアントは別の修復を使用して NdfRepairIncident を再度呼び出すことができます。

注釈

NdfRepairIncident は、NdfDiagnoseIncident が診断に使用されている場合にのみ呼び出すことができます。 これは通常、ユーザー インターフェイスが表示されないシナリオや、標準の Windows エクスペリエンスが使用されていないシナリオ (Media Center や埋め込みアプリケーションなど) の場合に当てはめます。 NdfExecuteDiagnosis を使用する場合は、NdfRepairIncident を呼び出さないでください。

この API を使用する前に、アプリケーションで NdfCreateWebIncident などのインシデント作成関数を呼び出して、NDF 診断 プロセスを開始する必要があります。 その後、アプリケーションは NdfDiagnoseIncident を呼び出して問題を診断します。 診断プロセスで可能な修復が特定された場合、アプリケーションは NdfRepairIncident を呼び出して、ユーザー インターフェイスを表示せずに問題を修復できます。 アプリケーションが進行中の NdfRepairIncident 呼び出しをキャンセルする場合は、必要に応じて、別のスレッドから NdfCancelIncident を呼び出すことができます。 最後に、アプリケーションは NdfCloseIncident を呼び出します。

要件

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

こちらもご覧ください

NdfDiagnoseIncident

RepairInfoEx