PeerGroupJoin-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupJoin-Funktion bereitet einen Peer mit einer Einladung vor, einer vorhandenen Peergruppe beizutreten, bevor PeerGroupConnect oder PeerGroupConnectByAddress aufgerufen wird.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parameter

[in] pwzIdentity

Zeiger auf eine Unicode-Zeichenfolge, die die Identität enthält, die die angegebene Peergruppe öffnet. Wenn dieser Parameter NULL ist, verwendet die Implementierung die Identität, die von PeerIdentityGetDefault abgerufen wurde.

[in] pwzInvitation

Zeiger auf eine Unicode-Zeichenfolge, die die VON einem anderen Peer gewährte XML-Einladung enthält. Eine Einladung wird erstellt, wenn der einladende Peer PeerGroupCreateInvitation oder PeerGroupIssueCredentials aufruft. Spezifische Details zu dieser Einladung können als PEER_INVITATION_INFO-Struktur abgerufen werden, indem Sie PeerGroupParseInvitation aufrufen. Dieser Parameter ist erforderlich.

[in] pwzCloud

Zeiger auf eine Unicode-Zeichenfolge, die den Namen der PNRP-Cloud enthält, in der sich eine Gruppe befindet. Der Standardwert ist NULL, was angibt, dass die in der Einladung angegebene Cloud verwendet werden muss.

[out] phGroup

Zeiger auf das Handle der Peergruppe. Rufen Sie PeerGroupConnect auf, um die Kommunikation mit einer Gruppe zu starten. 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 verfügbar, um den Vorgang abzuschließen.
PEER_E_CLOUD_NAME_AMBIGUOUS	Die Cloud kann nicht eindeutig ermittelt werden, z. B. entsprechen mehrere Clouds dem angegebenen Namen.
PEER_E_INVALID_PEER_NAME	Die in pwzIdentity angegebene Peeridentität ist ungültig.
PEER_E_INVALID_TIME_PERIOD	Der in der Einladung angegebene Gültigkeitszeitraum ist ungültig. Entweder ist der angegebene Zeitraum abgelaufen oder die Einladung ist noch nicht gültig (d. h. das angegebene Gültigkeitsdatum/uhrzeit wurde noch nicht erreicht). Ein möglicher Grund für die Rückgabe dieses Fehlers ist, dass die Systemuhr auf dem Computer, der der Gruppe angehört, oder auf dem Computer, der die Einladung ausgestellt hat, falsch festgelegt ist.
PEER_E_INVITATION_NOT_TRUSTED	Die Einladung ist nicht vertrauenswürdig. Dies kann auf Einladungsänderungen, Fehler oder Ablauf zurückzuführen sein.
PEER_E_NO_CLOUD	Die Cloud kann nicht gefunden werden.
PEER_E_UNSUPPORTED_VERSION	Die Einladung wird von der aktuellen Version der Peerinfrastruktur nicht unterstützt.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Peeridentität oder Peergruppenschlü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 wurde.

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

Anforderungen


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