Freigeben über


PeerGroupCreate-Funktion (p2p.h)

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