PeerCollabRefreshEndpointData-Funktion (p2p.h)

Artikel
08/25/2023

Die Funktion PeerCollabRefreshEndpointData aktualisiert den aufrufenden Peerknoten mit neuen Endpunktdaten.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
  [in] PCPEER_ENDPOINT pcEndpoint
);

Parameter

[in] pcEndpoint

Zeiger auf eine PEER_ENDPOINT-Struktur , die die aktualisierten Peerendpunktinformationen für den aktuellen Peerknoten enthält.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen.
E_INVALIDARG	Eines der Argumente ist ungültig.

Hinweise

PeerCollabRefreshEndpointData ermöglicht einer Anwendung das Aktualisieren von Daten, die dem Endpunkt zugeordnet sind. Nach Abschluss der API wird das PEER_EVENT_REQUEST_STATUS_CHANGED-Ereignis ausgelöst. Das Ereignis enthält einen Erfolgs- oder Fehlercode.

Bei Erfolg kann die Anwendung Funktionen wie PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects und PeerCollabQueryContactData aufrufen, um zusätzliche Daten abzurufen. Wenn die Daten nicht mehr benötigt werden, können sie durch Aufrufen von PeerCollabDeleteEndpointData gelöscht werden.

Wenn ein Peer für den Endpunkt abonniert wird, haben die abonnierten Daten eine höhere Priorität als die Daten, die durch Aufrufen von PeerCollabRefreshEndpointData zwischengespeichert wurden, und geben PEER_EVENT_REQUEST_STATUS_CHANGED zurück.

Die PeerCollabRefreshEndpointData-API übernimmt eine Momentaufnahme der Daten für den angegebenen Endpunkt. Wenn sich Endpunktdaten ändern, nachdem diese Momentaufnahme genommen wurde, verfügt der Aufrufer über eine veraltete Kopie der Daten. Wenn PeerCollabRefreshEndpointData von einer Anwendung mehrmals für denselben Endpunkt aufgerufen wird, ersetzen die zuletzt empfangenen Daten die daten, die von einem früheren Aufruf der API gespeichert wurden. Um jedoch sicherzustellen, dass der Aufrufer über Änderungen benachrichtigt wird und immer über die neueste Kopie verfügt, wird PeerCollabSubscribeEndpointData anstelle von PeerCollabRefreshEndpointData empfohlen.

Für die Funktion PeerCollabRefreshEndpointData beträgt das Timeout 30 Sekunden.

Anforderungen


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