Bagikan melalui

struktur PEER_INVITATION_INFO (p2p.h)

  • Artikel

Struktur PEER_INVITATION_INFO menentukan informasi tentang undangan untuk bergabung dengan grup serekan. Undangan direpresentasikan sebagai string Unicode. Untuk mendapatkan struktur ini, teruskan string undangan XML yang dibuat oleh PeerGroupCreateInvitation ke PeerGroupParseInvitation.

Sintaks

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

Anggota

dwSize

Menentukan ukuran struktur ini, dalam byte.

dwFlags

Harus diatur ke 0x00000000.

pwzCloudName

Penunjuk ke string Unicode yang menentukan nama cloud PNRP.

dwScope

Menentukan cakupan tempat grup serekan didaftarkan.

Nilai Makna
PNRP_GLOBAL_SCOPE
 Cakupan global, termasuk Internet.
PNRP_LOCAL_SCOPE
 Cakupan lokal.
PNRP_LINK_LOCAL_SCOPE
 Cakupan tautan lokal.

dwCloudFlags

Menentukan sekumpulan bendera yang menjelaskan fitur cloud PNRP.

Nilai Makna
PNRP_CLOUD_NO_FLAGS
0
 Tidak ada bendera yang ditetapkan.
PNRP_CLOUD_NAME_LOCAL
1
 Nama cloud tidak tersedia di komputer lain; ditentukan secara lokal.

pwzGroupPeerName

Penunjuk ke string Unicode yang menentukan nama serekan grup serekan.

pwzIssuerPeerName

Penunjuk ke string Unicode yang menentukan nama PNRP dari serekan yang mengeluarkan undangan.

pwzSubjectPeerName

Penunjuk ke string Unicode yang menentukan nama PNRP peer yang menerima undangan.

pwzGroupFriendlyName

Penunjuk ke string Unicode yang menentukan nama ramah (tampilan) dari grup serekan.

pwzIssuerFriendlyName

Penunjuk ke string Unicode yang menentukan nama ramah (tampilan) dari serekan yang mengeluarkan undangan.

pwzSubjectFriendlyName

Penunjuk ke string Unicode yang menentukan nama ramah (tampilan) dari peer yang menerima undangan.

ftValidityStart

Menentukan nilai UTC FILETIME yang menunjukkan kapan undangan menjadi valid.

ftValidityEnd

Menentukan nilai UTC FILETIME yang menunjukkan kapan undangan menjadi tidak valid.

cRoles

Menentukan jumlah GUID peran yang ada dalam pRoles.

pRoles

Arahkan ke daftar GUID yang menentukan kumpulan gabungan peran yang tersedia. Peran yang tersedia adalah sebagai berikut.

Nilai Makna
PEER_GROUP_ROLE_ADMIN
 Peran ini dapat mengeluarkan undangan, memperbarui keanggotaan, memodifikasi properti grup serekan, menerbitkan dan memperbarui rekaman, dan memperbarui GMC administrator lain.
PEER_GROUP_ROLE_MEMBER
 Peran bisa menerbitkan rekaman ke database grup serekan.

cClassifiers

Nilai bilangan bulat yang tidak ditandatangani yang berisi jumlah nilai string yang tercantum dalam ppwzClassifiers. Bidang ini disediakan untuk digunakan di masa mendatang.

ppwzClassifiers

Daftar penunjuk ke string Unicode. Bidang ini disediakan untuk digunakan di masa mendatang.

pSubjectPublicKey

Penunjuk ke struktur CERT_PUBLIC_KEY_INFO yang berisi kunci umum penerima yang dikembalikan dan jenis algoritma enkripsi yang digunakannya.

authScheme

Windows Vista atau yang lebih baru. Nilai enumerasi PEER_GROUP_AUTHENTICATION_SCHEME yang menunjukkan jenis autentikasi yang digunakan untuk memvalidasi undangan grup serekan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untukWindows XP
Server minimum yang didukung Tidak ada yang didukung
Header p2p.h

Lihat juga

PeerGroupParseInvitation