PeerCollabSubscribeEndpointData-Funktion (p2p.h)
Die Funktion PeerCollabSubscribeEndpointData erstellt ein Abonnement für einen verfügbaren Endpunkt.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
[in] const PCPEER_ENDPOINT pcEndpoint
);
Parameter
[in] pcEndpoint
Zeiger auf eine PEER_ENDPOINT-Struktur , die den Peerendpunkt enthält, der zum Abrufen von Anwesenheitsinformationen verwendet wird.
Rückgabewert
Gibt S_OK oder PEER_S_SUBSCRIPTION_EXISTS zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen. |
|
Eines der Argumente ist ungültig. |
|
Die Windows-Peer-Infrastruktur wird nicht initialisiert. Das Aufrufen der entsprechenden Initialisierungsfunktion ist erforderlich. |
Hinweise
PeerCollabSubscribeEndpointData ist ein asynchroner Aufruf, was bedeutet, dass der Prozess zum Abonnieren des Endpunkts gestartet, aber nicht unbedingt abgeschlossen wurde, wenn dieser Aufruf zurückgibt. Eine Anwendung sollte warten, bis PEER_EVENT_REQUEST_STATUS_CHANGED das Ergebnis der Abonnementanforderung erhält.
Für diese Funktion wird ein Timeout von 30 Sekunden ausgeführt.
PeerCollabSubscribeEndpointData kann mehrmals aus verschiedenen Anwendungen für denselben Endpunkt aufgerufen werden. Jeder Aufruf wird referenziert; nur wenn der letzte Verweis freigegeben wird, wird ein Peer abgemeldet. Um den Verweis freizugeben, rufen Sie PeerCollabUnsubscribeEndpointData auf.
Wenn eine Anwendung beendet wird, ohne PeerCollabUnsubscribeEndpointData aufzurufen, werden alle Verweise für diese Anwendung automatisch freigegeben.
Um die APIs PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects und PeerCollabQueryContactData erfolgreich aufzurufen, muss eine Anwendung zuerst PeerCollabSubscribeEndpointData aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |