Fungsi NdfRepairIncident (ndfapi.h)

Artikel
08/25/2023

Fungsi NdfRepairIncident memperbaiki insiden tanpa menampilkan antarmuka pengguna.

Sintaks

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

Parameter

[in] Handle

Jenis: NDFHANDLE

Tangani insiden Network Diagnostics Framework. Handel ini harus cocok dengan handel yang diteruskan ke NdfDiagnoseIncident.

[in] RepairEx

Jenis: RepairInfoEx*

Struktur (diperoleh dari NdfDiagnoseIncident) yang menunjukkan perbaikan tertentu yang akan dilakukan.

Memori yang dialokasikan untuk struktur ini nantinya harus dibebaskan. Untuk contoh cara melakukannya, lihat Sampel Diagnostik Jaringan Microsoft Windows.

dwWait

Jenis: DWORD

Lamanya waktu, dalam milidetik, untuk menunggu sebelum mengakhiri rutinitas diagnostik. INFINITE dapat diteruskan ke parameter ini jika tidak ada batas waktu yang diinginkan.

Mengembalikan nilai

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
S_OK	Perbaikan berhasil.
NDF_E_VALIDATION	Perbaikan berhasil dijalankan, tetapi validasi NDF masih menemukan masalah konektivitas. Jika nilai ini dikembalikan, sesi harus ditutup dengan memanggil NdfCloseIncident dan sesi lain harus dibuat untuk melanjutkan diagnosis.
E_HANDLE	Handel insiden NDF tidak valid.
WAIT_TIMEOUT	Operasi perbaikan telah dihentikan karena telah memakan waktu lebih lama dari waktu habis yang ditentukan dalam dwWait.

Kode kegagalan lainnya dikembalikan jika perbaikan gagal dijalankan. Dalam hal ini, klien dapat memanggil NdfRepairIncident lagi dengan perbaikan yang berbeda.

Keterangan

NdfRepairIncident hanya dapat dipanggil ketika NdfDiagnoseIncident digunakan untuk diagnostik. Ini biasanya terjadi dalam skenario di mana tidak ada antarmuka pengguna yang ditampilkan, atau di mana pengalaman Windows standar tidak digunakan (seperti halnya Media Center dan aplikasi yang disematkan). NdfRepairIncident tidak boleh dipanggil ketika NdfExecuteDiagnosis digunakan.

Sebelum menggunakan API ini, aplikasi harus memanggil fungsi pembuatan insiden seperti NdfCreateWebIncident untuk memulai proses diagnostik NDF. Aplikasi kemudian memanggil NdfDiagnoseIncident untuk mendiagnosis masalah. Jika proses diagnostik mengidentifikasi beberapa kemungkinan perbaikan, aplikasi dapat memanggil NdfRepairIncident untuk memperbaiki masalah tanpa menampilkan antarmuka pengguna. NdfCancelIncident secara opsional dapat dipanggil dari utas terpisah jika aplikasi ingin membatalkan panggilan NdfRepairIncident yang sedang berlangsung. Akhirnya, aplikasi memanggil NdfCloseIncident.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	ndfapi.h
Pustaka	Ndfapi.lib
DLL	Ndfapi.dll

Lihat juga

NdfDiagnoseIncident

RepairInfoEx

Bagikan melalui