PeerGroupPasswordJoin-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupPasswordJoin-Funktion bereitet einen Peer mit einer Einladung und dem richtigen Kennwort vor, um einer kennwortgeschützten Peergruppe beizutreten, bevor PeerGroupConnect oder PeerGroupConnectByAddress aufgerufen wird.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [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 aus PeerIdentityGetDefault abgerufen wurde.

[in] pwzInvitation

Zeiger auf eine Unicode-Zeichenfolge, die die XML-Einladung enthält, die von einem anderen Peer erteilt wurde. Eine Einladung mit einem Kennwort wird erstellt, wenn der einladende Peer PeerGroupCreatePasswordInvitation aufruft. Bestimmte Details zu dieser Einladung, einschließlich des vom Gruppenersteller festgelegten Kennworts, können als PEER_INVITATION_INFO-Struktur abgerufen werden, indem PeerGroupParseInvitation aufgerufen wird. Dieser Parameter ist erforderlich.

[in] pwzPassword

Zeiger auf eine Unicode-Zeichenfolge, die null endet und das Kennwort enthält, das zum Überprüfen und Beitreten zur Peergruppe erforderlich ist. Dieses Kennwort muss mit dem in der Einladung angegebenen Kennwort übereinstimmen. 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. Um die Kommunikation mit einer Gruppe zu starten, rufen Sie PeerGroupConnect auf. 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. stimmt mehr als eine Cloud mit dem angegebenen Namen überein.
PEER_E_INVALID_PEER_NAME	Die in pwzIdentity angegebene Peeridentität ist ungültig.
PEER_E_INVITATION_NOT_TRUSTED	Die Einladung wird vom Peer nicht als vertrauenswürdig eingestuft. Sie wurde geändert oder enthält Fehler.
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.
PEER_S_ALREADY_A_MEMBER	Der lokale Peer hat mehrmals versucht, einer Gruppe basierend auf einem Kennwort beizutreten.

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

Hinweise

Im Falle einer Uhrabweichung zwischen den teilnehmenden Computern kann die anfängliche PeerGroupPasswordJoin-Funktion weiterhin erfolgreich sein, während der folgende Aufruf von PeerGroupConnect abhängig vom Schweregrad der Abweichung zu einem Joinfehler führen kann.

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

Weitere Informationen

PeerGroupConnect

PeerGroupConnectByAddress

Freigeben über