PEER_INVITATION_INFO-Struktur (p2p.h)

Die PEER_INVITATION_INFO-Struktur definiert Informationen zu einer Einladung, einer Peergruppe beizutreten. Einladungen werden als Unicode-Zeichenfolgen dargestellt. Um diese Struktur abzurufen, übergeben Sie die von PeerGroupCreateInvitation erstellte XML-Einladungszeichenfolge an PeerGroupParseInvitation.

Syntax

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;

Member

dwSize

Gibt die Größe dieser Struktur in Bytes an.

dwFlags

Muss auf 0x00000000 festgelegt werden.

pwzCloudName

Zeiger auf eine Unicode-Zeichenfolge, die den PNRP-Cloudnamen angibt.

dwScope

Gibt den Bereich an, unter dem die Peergruppe registriert wurde.

Wert	Bedeutung
PNRP_GLOBAL_SCOPE	Globaler Bereich, einschließlich internet.
PNRP_LOCAL_SCOPE	Lokaler Bereich.
PNRP_LINK_LOCAL_SCOPE	Linklokaler Bereich.

dwCloudFlags

Gibt eine Reihe von Flags an, die PNRP-Cloudfeatures beschreiben.

Wert	Bedeutung
PNRP_CLOUD_NO_FLAGS 0	Es sind keine Flags festgelegt.
PNRP_CLOUD_NAME_LOCAL 1	Der Cloudname ist auf anderen Computern nicht verfügbar. es ist lokal definiert.

pwzGroupPeerName

Zeiger auf eine Unicode-Zeichenfolge, die den Peernamen der Peergruppe angibt.

pwzIssuerPeerName

Zeiger auf eine Unicode-Zeichenfolge, die den PNRP-Namen des Peers angibt, der die Einladung ausgibt.

pwzSubjectPeerName

Zeiger auf eine Unicode-Zeichenfolge, die den PNRP-Namen des Peers angibt, der die Einladung empfängt.

pwzGroupFriendlyName

Zeiger auf eine Unicode-Zeichenfolge, die den Anzeigenamen der Peergruppe angibt.

pwzIssuerFriendlyName

Zeiger auf eine Unicode-Zeichenfolge, die den Anzeigenamen des Peers angibt, der die Einladung ausgibt.

pwzSubjectFriendlyName

Zeiger auf eine Unicode-Zeichenfolge, die den Anzeigenamen des Peers angibt, der die Einladung empfängt.

ftValidityStart

Gibt einen UTC FILETIME-Wert an, der angibt, wann die Einladung gültig wird.

ftValidityEnd

Gibt einen UTC FILETIME-Wert an, der angibt, wann die Einladung ungültig wird.

cRoles

Gibt die Anzahl der Rollen-GUIDs an, die in pRoles vorhanden sind.

pRoles

Zeiger auf eine Liste von GUIDs, die den kombinierten Satz verfügbarer Rollen angibt. Die verfügbaren Rollen sind wie folgt:

Wert	Bedeutung
PEER_GROUP_ROLE_ADMIN	Diese Rolle kann Einladungen ausstellen, Mitgliedschaften verlängern, Peergruppeneigenschaften ändern, Datensätze veröffentlichen und aktualisieren und die GMC anderer Administratoren erneuern.
PEER_GROUP_ROLE_MEMBER	Die Rolle kann Datensätze in der Peergruppendatenbank veröffentlichen.

cClassifiers

Ganzzahlwert ohne Vorzeichen, der die Anzahl der in ppwzClassifiers aufgeführten Zeichenfolgenwerte enthält. Dieses Feld ist für eine spätere Verwendung vorgesehen.

ppwzClassifiers

Liste der Zeiger auf Unicode-Zeichenfolgen. Dieses Feld ist für eine spätere Verwendung vorgesehen.

pSubjectPublicKey

Zeiger auf eine CERT_PUBLIC_KEY_INFO-Struktur , die den zurückgegebenen öffentlichen Schlüssel des Empfängers und den verwendeten Verschlüsselungsalgorithmustyp enthält.

authScheme

Windows Vista oder höher. Der PEER_GROUP_AUTHENTICATION_SCHEME Enumerationswert, der den Typ der Authentifizierung angibt, die zum Überprüfen der eingeladenen Peergruppe verwendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	p2p.h

Weitere Informationen

PeerGroupParseInvitation