Condividi tramite


struttura PEER_INVITATION_INFO (p2p.h)

La struttura PEER_INVITATION_INFO definisce informazioni su un invito a partecipare a un gruppo peer. Gli inviti sono rappresentati come stringhe Unicode. Per ottenere questa struttura, passare la stringa di invito XML creata da PeerGroupCreateInvitation a PeerGroupParseInvitation.

Sintassi

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;

Members

dwSize

Specifica le dimensioni di questa struttura, in byte.

dwFlags

Deve essere impostato su 0x00000000.

pwzCloudName

Puntatore a una stringa Unicode che specifica il nome del cloud PNRP.

dwScope

Specifica l'ambito in cui è stato registrato il gruppo peer.

Valore Significato
PNRP_GLOBAL_SCOPE
Ambito globale, incluso Internet.
PNRP_LOCAL_SCOPE
Ambito locale.
PNRP_LINK_LOCAL_SCOPE
Ambito locale del collegamento.

dwCloudFlags

Specifica un set di flag che descrivono le funzionalità cloud PNRP.

Valore Significato
PNRP_CLOUD_NO_FLAGS
0
Nessun flag impostato.
PNRP_CLOUD_NAME_LOCAL
1
Il nome del cloud non è disponibile in altri computer; è definito localmente.

pwzGroupPeerName

Puntatore a una stringa Unicode che specifica il nome peer del gruppo peer.

pwzIssuerPeerName

Puntatore a una stringa Unicode che specifica il nome PNRP del peer che emette l'invito.

pwzSubjectPeerName

Puntatore a una stringa Unicode che specifica il nome PNRP del peer che riceve l'invito.

pwzGroupFriendlyName

Puntatore a una stringa Unicode che specifica il nome descrittivo (visualizzato) del gruppo peer.

pwzIssuerFriendlyName

Puntatore a una stringa Unicode che specifica il nome descrittivo (visualizzato) del peer che emette l'invito.

pwzSubjectFriendlyName

Puntatore a una stringa Unicode che specifica il nome descrittivo (visualizzato) del peer che riceve l'invito.

ftValidityStart

Specifica un valore FILETIME UTC che indica quando l'invito diventa valido.

ftValidityEnd

Specifica un valore FILETIME UTC che indica quando l'invito diventa non valido.

cRoles

Specifica il numero di GUID del ruolo presenti in pRoles.

pRoles

Puntatore a un elenco di GUID che specifica il set combinato di ruoli disponibili. I ruoli disponibili sono i seguenti.

Valore Significato
PEER_GROUP_ROLE_ADMIN
Questo ruolo può inviare inviti, rinnovare le appartenenze, modificare le proprietà del gruppo peer, pubblicare e aggiornare i record e rinnovare il GMC di altri amministratori.
PEER_GROUP_ROLE_MEMBER
Il ruolo può pubblicare record nel database del gruppo peer.

cClassifiers

Valore intero senza segno che contiene il numero di valori stringa elencati in ppwzClassifiers. Questo campo è riservato per un utilizzo futuro.

ppwzClassifiers

Elenco di puntatori alle stringhe Unicode. Questo campo è riservato per un utilizzo futuro.

pSubjectPublicKey

Puntatore a una struttura di CERT_PUBLIC_KEY_INFO che contiene la chiave pubblica restituita del destinatario e il tipo di algoritmo di crittografia utilizzato.

authScheme

Windows Vista o versione successiva. Valore di enumerazione PEER_GROUP_AUTHENTICATION_SCHEME che indica il tipo di autenticazione usato per convalidare l'invito al gruppo peer.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato Nessuno supportato
Intestazione p2p.h

Vedi anche

PeerGroupParseInvitation