Функция PeerGroupOpenDirectConnection (p2p.h)

Статья
08/25/2023

Функция PeerGroupOpenDirectConnection устанавливает прямое соединение с другим одноранговым элементом в одноранговой группе.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Параметры

[in] hGroup

Обработка одноранговой группы, в которую размещается прямое подключение. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] pwzIdentity

Указатель на строку Юникода, содержащую удостоверение, к которому подключается одноранговый узел. Это обязательный параметр.

[in] pAddress

Указатель на структуру PEER_ADDRESS , содержащую IPv6-адрес, к которому подключается одноранговый узел. Это обязательный параметр.

[out] pullConnectionId

64-разрядное целое число без знака, определяющее прямое подключение. Это значение идентификатора нельзя считать допустимым до тех пор, пока не будет вызвано событие PEER_GROUP_EVENT_DIRECT_CONNECTION и не будет указано, что подключение было принято другим одноранговым элементом. Это обязательный параметр.

Возвращаемое значение

Возвращает S_OK , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
PEER_E_CONNECT_SELF	Сбой подключения, так как он был замыкается на себя, то есть соединение находится между узлом и самим узлом.
PEER_E_NO_KEY_ACCESS	Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов запрещен. Обычно это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти при сбросе списка ACL вручную.

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Каждое прямое соединение, открытое с помощью этой функции, должно быть закрыто с помощью структуры PEER_GROUP_EVENT DATA , для которого задано значение PEER_CONNECTION_FAILED для компонента PEER_EVENT_CONNECTION_CHANGE_DATA структуры.

Требования


Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2P.lib
DLL	P2P.dll