PeerGroupJoin-Funktion (p2p.h)
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 |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
Die Cloud kann nicht eindeutig ermittelt werden, z. B. entsprechen mehrere Clouds dem angegebenen Namen. |
|
Die in pwzIdentity angegebene Peeridentität ist ungültig. |
|
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. |
|
Die Einladung ist nicht vertrauenswürdig. Dies kann auf Einladungsänderungen, Fehler oder Ablauf zurückzuführen sein. |
|
Die Cloud kann nicht gefunden werden. |
|
Die Einladung wird von der aktuellen Version der Peerinfrastruktur nicht unterstützt. |
|
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 |