Функция PeerCollabRefreshEndpointData (p2p.h)
Функция PeerCollabRefreshEndpointData обновляет вызывающий одноранговый узел новыми данными конечной точки.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
Параметры
[in] pcEndpoint
Указатель на структуру PEER_ENDPOINT , которая содержит обновленные сведения о конечной точке однорангового узла для текущего однорангового узла.
Возвращаемое значение
Возвращает S_OK, если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Недостаточно памяти для поддержки этой операции. |
|
Один из аргументов является недопустимым. |
Комментарии
PeerCollabRefreshEndpointData позволяет приложению обновлять данные, связанные с конечной точкой. После завершения РАБОТЫ API возникает событие PEER_EVENT_REQUEST_STATUS_CHANGED. Событие будет содержать код успеха или сбоя.
При успешном выполнении приложение может вызывать такие функции, как PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects и PeerCollabQueryContactData , для получения дополнительных данных. Если данные больше не нужны, их можно удалить, вызвав PeerCollabDeleteEndpointData.
Если одноранговый узел подписан на конечную точку, подписанные данные имеют более высокий приоритет, чем данные, кэшированные путем вызова PeerCollabRefreshEndpointData, и возвращают PEER_EVENT_REQUEST_STATUS_CHANGED.
API PeerCollabRefreshEndpointData принимает snapshot данных для указанной конечной точки. Если данные конечной точки изменяются после snapshot, вызывающий объект будет иметь устаревшую копию данных. Если peerCollabRefreshEndpointData вызывается приложением несколько раз для одной и той же конечной точки, последние полученные данные заменяют данные, хранящиеся при предыдущем вызове API. Однако, чтобы убедиться, что вызывающий объект уведомляется о любых изменениях и всегда имеет последнюю копию, рекомендуется использовать PeerCollabSubscribeEndpointData вместо PeerCollabRefreshEndpointData.
Время ожидания функции PeerCollabRefreshEndpointData составит 30 секунд.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |