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.

dwCloudFlags

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

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:

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

Weitere Informationen

PeerGroupParseInvitation