Bagikan melalui

Fungsi NdfCreateGroupingIncident (ndfapi.h)

  • Artikel

Fungsi NdfCreateGroupingIncident membuat sesi untuk mendiagnosis masalah fungsionalitas pengelompokan peer-to-peer.

Sintaks

HRESULT NdfCreateGroupingIncident(
  [in, optional] LPCWSTR             CloudName,
  [in, optional] LPCWSTR             GroupName,
  [in, optional] LPCWSTR             Identity,
  [in, optional] LPCWSTR             Invitation,
  [in, optional] SOCKET_ADDRESS_LIST *Addresses,
  [in, optional] LPCWSTR             appId,
  [out]          NDFHANDLE           *handle
);

Parameter

[in, optional] CloudName

Jenis: LPCWSTR

Nama cloud Protokol Resolusi Nama Serekan (PNRP) tempat grup dibuat. Jika NULL, sesi tidak akan mencoba mendiagnosis masalah yang terkait dengan PNRP.

[in, optional] GroupName

Jenis: LPCWSTR

Nama grup yang akan didiagnosis. Jika NULL, sesi tidak akan mencoba mendiagnosis masalah yang terkait dengan ketersediaan grup.

[in, optional] Identity

Jenis: LPCWSTR

Identitas yang digunakan serekan untuk mengakses grup. Jika NULL, sesi tidak akan mencoba mendiagnosis masalah yang terkait dengan kemampuan grup untuk mendaftar di PNRP.

[in, optional] Invitation

Jenis: LPCWSTR

Undangan XML yang diberikan oleh serekan lain. Undangan dibuat saat serekan yang mengundang memanggil PeerGroupCreateInvitation atau PeerGroupIssueCredentials. Jika nilai ini ada, undangan akan diperiksa untuk memastikan format dan kedaluwarsanya valid.

[in, optional] Addresses

Jenis: SOCKET_ADDRESS_LIST*

Daftar alamat opsional rekan-rekan yang coba disambungkan oleh aplikasi. Jika parameter ini digunakan, kelas pembantu akan mendiagnosis konektivitas ke alamat ini.

[in, optional] appId

Jenis: LPCWSTR

ID aplikasi untuk aplikasi panggilan.

[out] handle

Jenis: NDFHANDLE*

Tangani insiden Network Diagnostics Framework.

Nilai kembali

Jenis: HRESULT

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

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil.
NDF_E_BAD_PARAM
 Satu atau beberapa parameter belum disediakan dengan benar.

Keterangan

Tingkat diagnosis yang dilakukan tergantung pada parameter yang disediakan.

  • Jika tidak ada parameter yang ditentukan, NDF akan memvalidasi status layanan pengelompokan, status layanan peer-to-peer (PNRP dan Identity Manager), dan sinkronisasi jam Windows.
  • Jika CloudName ditentukan, NDF akan memvalidasi fungsionalitas pengelompokan di cloud tersebut.
  • Jika GroupName ditentukan, NDF akan memvalidasi bahwa nama dapat diselesaikan di PNRP (atau memanggil kelas pembantu PNRP jika nama tidak dapat diselesaikan) dan memvalidasi pengaturan firewall untuk pengelompokan.
  • Jika Identitas ditentukan, NDF akan memvalidasi kemampuan PNRP untuk mendaftarkan GroupName dengan Identitas ini. Jika ini gagal, kelas pembantu PNRP akan dipanggil.
  • Jika Undangan ditentukan, GroupName akan berasal dari Undangan (jika GroupName tidak juga ditentukan) dan NDF akan memvalidasi format dan status undangan.
  • Jika Alamat ditentukan, NDF akan memvalidasi apakah Windows dapat tersambung hingga tiga alamat ini.

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