Функция PeerCollabInviteEndpoint (p2p.h)
Функция PeerCollabInviteEndpoint отправляет приглашение в указанную конечную точку однорангового узла для присоединения к одноранговой совместной работе отправителя. Этот вызов является синхронным и в случае успешного выполнения получает ответ от конечной точки однорангового узла.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteEndpoint(
[in] PCPEER_ENDPOINT pcEndpoint,
[in] PCPEER_INVITATION pcInvitation,
[out] PPEER_INVITATION_RESPONSE *ppResponse
);
Параметры
[in] pcEndpoint
Указатель на структуру PEER_ENDPOINT , содержащую сведения о приглашенном одноранговом узле. Этот одноранговый узел отправляет приглашение при вызове этого API.
Для этого параметра не должно быть задано значение NULL.
[in] pcInvitation
Указатель на структуру PEER_INVITATION , содержащую запрос приглашения для отправки в конечную точку, указанную в pcEndpoint. Для этого параметра не должно быть задано значение NULL.
[out] ppResponse
Указатель на структуру PEER_INVITATION_RESPONSE , которая получает ответы приглашенной одноранговой конечной точки на запрос приглашения.
Если этот вызов завершается ошибкой, в выходных данных этот параметр будет иметь значение NULL.
Освободите память, связанную с этой структурой, передав ее в PeerFreeData.
Возвращаемое значение
Возвращает S_OK, если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Недостаточно памяти для поддержки этой операции. |
|
Один из аргументов недопустим. |
|
Получатель приглашения не ответил в течение 5 минут. |
Комментарии
Этот API отправляет приглашение в конечную точку, указанную в качестве входных данных. Это не гарантирует, что получателем приглашения является конкретный контакт, которому пользователь намеревается отправить приглашение. Чтобы убедиться, что приглашение отправлено правильному контакту, вызовите PeerCollabInviteContact.
Появится всплывающее уведомление для получателя приглашения. Это всплывающее уведомление будет преобразовано в диалоговое окно, в котором пользователь может принять или отклонить приглашение. После успешного принятия приглашения приложение для совместной работы запускается на компьютере получателя.
Для успешного получения приглашения приложение должно быть зарегистрировано на компьютере получателя с помощью PeerCollabRegisterApplication. Кроме того, отправитель приглашения может вернуть коды сбоев, так как получатель отключил приглашения приложений.
Получатель приглашения должен ответить в течение 5 минут, чтобы избежать истечения времени ожидания.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |