共用方式為

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 。

備註

只有在 NdfDiagnoseIncident 用於診斷時，才能呼叫 NdfRepairIncident。 這通常是在未顯示任何使用者介面的案例中，或標準 Windows 體驗未與媒體中心和內嵌應用程式) 一樣使用 (的情況。 NdfRepairIncident 不應該在使用 NdfExecuteDiagn， 呼叫。

使用此 API 之前，應用程式必須呼叫事件建立函式，例如 NdfCreateWebIncident ，才能開始 NDF 診斷程式。 應用程式接著會呼叫 NdfDiagnoseIncident 來診斷問題。 如果診斷程序識別出一些可能的修復，應用程式可以呼叫 NdfRepairIncident 來修復問題，而不顯示使用者介面。 如果應用程式想要取消進行中的 NdfRepairIncident 呼叫，可以選擇性地從個別線程呼叫 NdfCancelIncident。 最後，應用程式會呼叫 NdfCloseIncident。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 ndfapi.h
程式庫 Ndfapi.lib
Dll Ndfapi.dll

另請參閱

NdfDiagnoseIncident

RepairInfoEx