Fungsi NdfDiagnoseIncident (ndfapi.h)

Artikel
08/25/2023

Fungsi NdfDiagnoseIncident mendiagnosis akar penyebab insiden tanpa menampilkan antarmuka pengguna.

Sintaks

void NdfDiagnoseIncident(
  [in]  NDFHANDLE     Handle,
  [out] ULONG         *RootCauseCount,
  [out] RootCauseInfo **RootCauses,
        DWORD         dwWait,
        DWORD         dwFlags
);

Parameter

[in] Handle

Jenis: NDFHANDLE

Handel untuk insiden Network Diagnostics Framework.

[out] RootCauseCount

Jenis: ULONG*

Jumlah akar penyebab yang berpotensi menyebabkan insiden ini. Jika diagnosis tidak berhasil, konten parameter ini harus diabaikan.

[out] RootCauses

Jenis: RootCauseInfo**

Kumpulan struktur RootCauseInfo yang berisi deskripsi terperinci tentang akar penyebabnya. Jika diagnosis berhasil, parameter ini berisi akar daun penyebab yang diidentifikasi dalam sesi diagnosis dan akar penyebab non-daun yang memiliki perbaikan yang tersedia. Jika diagnosis tidak berhasil, konten parameter ini harus diabaikan.

Memori yang dialokasikan untuk struktur ini nantinya harus dikosongkan. 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 waktu habis yang diinginkan.

dwFlags

Jenis: DWORD

Nilai yang memungkinkan:

Nilai	Makna
NDF_ADD_CAPTURE_TRACE 0x0001	Mengaktifkan pelacakan jaringan selama diagnosis. Hasil diagnostik akan disertakan dalam file Log Jejak Peristiwa (ETL) yang dikembalikan oleh NdfGetTraceFile.
NDF_APPLY_INCLUSION_LIST_FILTER 0x0002	Menerapkan pemfilteran ke akar penyebab yang dikembalikan sehingga konsisten dengan perilaku diagnostik skrip dalam kotak. Tanpa bendera ini, akar penyebab tidak akan difilter. Bendera ini harus diatur oleh pemanggil, sehingga penelepon yang ada tidak akan melihat perubahan perilaku kecuali mereka secara eksplisit menentukan bendera ini. Catatan Hanya tersedia di Windows 8 dan Windows Server 2012.

Nilai

Makna

NDF_ADD_CAPTURE_TRACE
0x0001

Mengaktifkan pelacakan jaringan selama diagnosis. Hasil diagnostik akan disertakan dalam file Log Jejak Peristiwa (ETL) yang dikembalikan oleh NdfGetTraceFile.

NDF_APPLY_INCLUSION_LIST_FILTER
0x0002

Menerapkan pemfilteran ke akar penyebab yang dikembalikan sehingga konsisten dengan perilaku diagnostik skrip dalam kotak. Tanpa bendera ini, akar penyebab tidak akan difilter. Bendera ini harus diatur oleh pemanggil, sehingga penelepon yang ada tidak akan melihat perubahan perilaku kecuali mereka secara eksplisit menentukan bendera ini.

Catatan Hanya tersedia di Windows 8 dan Windows Server 2012.

Nilai kembali

Jenis: HRESULT

Nilai yang mungkin dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_HANDLE	Handel insiden NDF tidak valid.
WAIT_TIMEOUT	Rutinitas diagnostik telah dihentikan karena telah memakan waktu lebih lama dari waktu habis yang ditentukan dalam dwWait.

Keterangan

Fungsi ini ditujukan untuk digunakan dengan 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). NdfExecuteDiagnosis akan meluncurkan antarmuka pengguna diagnostik, dan harus digunakan dalam skenario menggunakan pengalaman Windows standar. Anda dapat memanggil NdfExecuteDiagnosis atau NdfDiagnoseIncident, tetapi tidak keduanya.

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 NdfDiagnoseIncident yang sedang berlangsung. Akhirnya, aplikasi memanggil NdfCloseIncident.

Tabel berikut ini memperlihatkan beberapa contoh akar penyebab dan perbaikan yang sesuai.

GUID akar penyebab	Perbaiki GUID	Deskripsi akar penyebab	Deskripsi perbaikan
{4DA030B8-86E5-4b6a-A879-2FFF8443B527}	{1296DFF0-D04E-4be1-A512-90F04DDFA3E6}	Kabel jaringan tidak dicolokkan dengan benar atau mungkin rusak.	Colokkan kabel Ethernet ke komputer ini.\nKabel Ethernet terlihat seperti kabel telepon tetapi dengan konektor yang lebih besar di ujungnya. Colokkan kabel ini ke dalam pembukaan di bagian belakang atau samping komputer.\nPastikan ujung kabel lainnya dicolokkan ke perute. Jika itu tidak membantu, coba gunakan kabel yang berbeda.
{60372FD2-AD60-45c2-BD83-6B827FC438DF}	{07d37f7b-fa5e-4443-bda7-ab107b29afb6}	Adapter %InterfaceName% dinonaktifkan.	Aktifkan adaptor %FriendlyInterfaceName%.
{245A9D66-AE9C-4518-A5B4-655752b0A5BD}	{07d37f7b-fa5e-4443-bda7-ab107b29afb9}	%InterfaceName%"" tidak memiliki konfigurasi IP yang valid.	Atur ulang adapter ""%InterfaceName%"".\nIni terkadang dapat mengatasi masalah terputus-terputus.

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

NdfExecuteDiagnosis

NdfGetTraceFile

RootCauseInfo

Bagikan melalui