PeerGroupCreate-Funktion (p2p.h)

Artikel
08/25/2023

Die Funktion PeerGroupCreate erstellt eine neue Peergruppe.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Parameter

[in] pProperties

Zeiger auf eine PEER_GROUP_PROPERTIES-Struktur , die die spezifischen Details der Gruppe angibt, z. B. peergruppennamen, Einladungsdauern und Anwesenheitsdauern. Dieser Parameter ist erforderlich.

Die folgenden Elemente müssen festgelegt werden:

pwzCreatorPeerName

Die folgenden Elemente können nicht festgelegt werden:

pwzGroupPeerName

Die restlichen Member sind optional.

[out] phGroup

Gibt den Handlezeiger auf die Peergruppe zurück. Jede Funktion, die mit diesem Handle als Parameter aufgerufen wird, hat die entsprechende Aktion für diese Peergruppe ausgeführt. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_CLOUD_NAME_AMBIGUOUS	Die in pProperties angegebene Cloud kann nicht eindeutig ermittelt werden (mehrere Clouds entsprechen dem angegebenen Namen).
PEER_E_INVALID_CLASSIFIER	Der in pProperties angegebene Peergruppenklassifizierer ist ungültig.
PEER_E_INVALID_PEER_NAME	Der für die Gruppe in pProperties angegebene Peername ist ungültig.
PEER_E_INVALID_PROPERTIES	Mindestens eine der in pProperties bereitgestellten Peergruppeneigenschaften ist ungültig.
PEER_E_NO_CLOUD	Die in pProperties angegebene Cloud kann nicht gefunden werden.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Identitäts- oder Gruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wird.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	Das angegebene Kennwort erfüllt nicht die Systemkennwortanforderungen.
ERROR_DELETE_PENDING	Die als Gruppenersteller angegebene Peeridentität wurde gelöscht oder wird gerade gelöscht.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

PeerGroupConnect muss vom Gruppenersteller unmittelbar nach der Erstellung aufgerufen werden. Wenn dies nicht geschieht, rufen Benutzer, die eine Einladung erhalten, PeerGroupConnect erfolgreich auf, können jedoch nicht lauschen und erhalten schließlich das Verbindungsereignis fehlgeschlagen.

Eine Anwendung ruft eine Identität ab, indem sie PeerIdentityCreate oder eine andere Methode aufruft, die eine Identitätsnamenzeichenfolge zurückgibt. Diese Identität dient als Besitzer der Gruppe und ist beim Erstellen das erste Mitglied der Peergruppe.

Für Anwendungen, die Kennwörter verwenden, wird empfohlen, dass die Kennwörter sicher verarbeitet werden, indem die Funktionen CryptoProtectMemory und SecureZeroMemory aufgerufen werden.

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
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

Weitere Informationen

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen

Share via