PeerGroupConnect-Funktion (p2p.h)
Die PeerGroupConnect-Funktion initiiert eine PNRP-Suche nach einer Peergruppe und versucht, eine Verbindung mit dieser herzustellen. Nachdem diese Funktion erfolgreich aufgerufen wurde, kann ein Peer mit anderen Mitgliedern der Peergruppe kommunizieren.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
Parameter
[in] hGroup
Handle mit der Peergruppe, mit der ein Peer eine Verbindung herstellen möchte. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen, PeerGroupJoin oder PeerGroupPasswordJoin zurückgegeben. Dieser Parameter ist erforderlich.
Rückgabewert
Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion den folgenden Wert zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Handle für die Peergruppe ist ungültig. |
Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.
Hinweise
Eine Anwendung registriert sich für Peerereignisse, bevor diese Funktion aufgerufen wird. Wenn der Funktionsaufruf nicht erfolgreich ist, wird ein PEER_GROUP_EVENT_CONNECTION_FAILED-Ereignis ausgelöst. Andernfalls wird ein PEER_GROUP_EVENT_STATUS_CHANGED-Ereignis ausgelöst.
Das PEER_GROUP_EVENT_CONNECTION_FAILED-Ereignis wird auch ausgelöst, wenn ein Gruppenersteller PeerGroupConnect nicht direkt nach der Erstellung aufrufen kann. 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.
Im Falle einer Uhrabweichung zwischen den teilnehmenden Computern hängt der Erfolg von PeerGroupConnect möglicherweise vom Schweregrad der Abweichung ab. Bei der Problembehandlung bei einem Fehler beim Join sollte diese Möglichkeit in Betracht gezogen werden, indem überprüft wird, ob die Computeruhren synchronisiert sind.
Verwenden Sie die Funktion PeerGroupOpen , um in der Peergruppe vorhanden zu sein und Ereignisse zu empfangen, aber nicht verbunden bleiben.
Wenn in der Anwendung kein Timeoutwert für PeerGroupConnect angegeben wird, führt ein Fehler dazu, dass die Anwendung hängen bleibt. Ein Timeoutwert von 30 Sekunden wird empfohlen.
Vor dem Aufrufen von PeerGroupConnect befindet sich eine Gruppe in einem "Getrennten Zustand". Während dieser Zeit kann die Gruppe nicht erkannt werden oder keine Verbindungen empfangen. Um eine Gruppe in diesen Zustand zurückzugeben, muss die Funktion PeerGroupClose 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 |