PEER_GROUP_PROPERTIES-Struktur (p2p.h)

Die PEER_GROUP_PROPERTIES-Struktur enthält Daten zur Mitgliedschaftsrichtlinie einer Peergruppe.

Syntax

typedef struct peer_group_properties_tag {
  DWORD        dwSize;
  DWORD        dwFlags;
  PWSTR        pwzCloud;
  PWSTR        pwzClassifier;
  PWSTR        pwzGroupPeerName;
  PWSTR        pwzCreatorPeerName;
  PWSTR        pwzFriendlyName;
  PWSTR        pwzComment;
  ULONG        ulMemberDataLifetime;
  ULONG        ulPresenceLifetime;
  DWORD        dwAuthenticationSchemes;
  PWSTR        pwzGroupPassword;
  PEER_ROLE_ID groupPasswordRole;
} PEER_GROUP_PROPERTIES, *PPEER_GROUP_PROPERTIES;

Member

dwSize

Größe der Struktur in Bytes.

dwFlags

PEER_GROUP_PROPERTY_FLAGS Flags, die das Verhalten einer Peergruppe beschreiben. Der Standardwert ist Null (0), was angibt, dass Flags nicht festgelegt sind.

pwzCloud

Gibt den Namen der PNRP-Cloud (Peer Name Resolution Protocol) an, an der eine Peergruppe teilnimmt. Der Standardwert ist "global", wenn dieser Member NULL ist.

pwzClassifier

Gibt den Klassifizierer an, der verwendet wird, um die Autorität eines Peergruppenpeernamens für die Registrierung oder Auflösung innerhalb einer PNRP-Cloud zu identifizieren. Die maximale Größe dieses Felds beträgt 149 Unicode-Zeichen. Dieser Member kann NULL sein.

pwzGroupPeerName

Gibt den Namen einer Peergruppe an, die beim PNRP-Dienst registriert ist. Die maximale Größe dieses Felds beträgt 137 Unicode-Zeichen.

pwzCreatorPeerName

Gibt den Peernamen an, der dem Peergruppenersteller zugeordnet ist. Die maximale Größe dieses Felds beträgt 137 Unicode-Zeichen. Wenn dieser Strukturmember NULL ist, verwendet die Implementierung die Identität, die von PeerIdentityGetDefault abgerufen wurde.

pwzFriendlyName

Gibt den Anzeigenamen einer Peergruppe an. Die maximale Größe dieses Felds beträgt 255 Zeichen.

pwzComment

Enthält einen Kommentar, der verwendet wird, um eine Peergruppe zu beschreiben. Die maximale Größe dieses Felds beträgt 255 Zeichen.

ulMemberDataLifetime

Gibt die Lebensdauer von Peergruppenmitgliedsdaten (PEER_MEMBER) in Sekunden an. Der Mindestwert für dieses Feld beträgt 8 Stunden, und der Höchstwert beträgt 10 Jahre. Der Standardwert ist 2.419.200 Sekunden oder 28 Tage.

Wenn dieser Wert auf Null (0) festgelegt ist, haben Memberdaten die maximal zulässige Lebensdauer, d. h. die verbleibende Zeit in der Lebensdauer des Administrators, der die Anmeldeinformationen für ein Mitglied ausgibt.

ulPresenceLifetime

Gibt die Lebensdauer von Anwesenheitsinformationen in Sekunden an, die in einer Peergruppe veröffentlicht werden. Der Standardwert beträgt 300 Sekunden. Legen Sie den Wert von ulPresenceLifetime nicht auf weniger als 300 Sekunden fest. Wenn dieser Member auf weniger als den Standardwert von 300 Sekunden festgelegt ist, kann ein undefiniertes Verhalten auftreten.

dwAuthenticationSchemes

Windows Vista oder höher. Logisches OR von PEER_GROUP_AUTHENTICATION_SCHEME Enumerationswerte, die die von der Peergruppe unterstützten Authentifizierungstypen angeben.

pwzGroupPassword

Windows Vista oder höher. Zeiger auf eine Unicode-Zeichenfolge, die das Kennwort zum Authentifizieren von Peers enthält, die versuchen, der Peergruppe beizutreten.

groupPasswordRole

Windows Vista oder höher. GUID-Wert, der die Peergruppenrolle angibt, für die das Kennwort für die Authentifizierung erforderlich ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	p2p.h

Weitere Informationen

PeerGroupErstellen

PeerGroupGetProperties

PeerGroupSetProperties