Поделиться через

Функции API группирования

  • Статья

API группирования использует следующие функции:

Функции инициализации и очистки групп

Функция Описание
PeerGroupShutdown Закрывает одноранговую группу, созданную с помощью PeerGroupStartup и удаляет все выделенные ресурсы.
PeerGroupStartup Инициирует одноранговую группу с помощью запрошенной версии инфраструктуры одноранговых узлов.

 

Функции создания групп и доступа

Функция Описание
PeerGroupClose Отменяет дескриптор одноранговой группы, полученный предыдущим вызовом функции PeerGroupCreate, PeerGroupJoinили PeerGroupOpen.
PeerGroupConnect Инициирует поиск одноранговой группы PNRP и пытается подключиться к ней. После успешного вызова этой функции одноранговый узел может взаимодействовать с другими членами одноранговой группы.
PeerGroupConnectByAddress Пытается подключиться к группе одноранговых узлов, в которую участвуют другие одноранговые узлы с известными IPv6-адресами.
PeerGroupCreate Создает новую одноранговую группу.
PeerGroupCreateInvitation Возвращает XML-строку, которую может использовать указанный одноранговый узел для присоединения к группе.
PeerGroupCreatePasswordInvitation Возвращает XML-строку, которую может использовать указанный одноранговый узел для соединения группы с соответствующим паролем.
PeerGroupDelete Удаляет локальные данные и сертификаты, связанные с одноранговой группой.
PeerGroupGetStatus Извлекает текущее состояние группы.
PeerGroupIssueCredentials Выдает учетные данные, включая GMC, для определенного удостоверения и при необходимости возвращает xml-строку приглашения, которая может использовать приглашенный одноранговый узел для присоединения к одноранговой группе.
PeerGroupJoin Разрешает одноранговой группе с приглашением присоединиться к существующей группе одноранговых узлов.
PeerGroupOpen Открывает группу однорангового узла, созданную или присоединенную к нему.
PeerGroupParseInvitation Возвращает структуру PEER_INVITATION_INFO с подробными сведениями о конкретном приглашении.
PeerGroupPasswordJoin Позволяет одноранговой группе с приглашением и правильным паролем присоединиться к группе одноранговых узлов, защищенной паролем.

 

Функции сведений о группах и членах

Функция Описание
PeerGroupEnumMembers Создает перечисление доступных членов одноранговых групп и связанных сведений о членстве.
PeerGroupGetProperties Извлекает сведения о свойствах указанной группы.
PeerGroupSetProperties Задает текущие свойства группы одноранговых узлов. В версии 1.0 этого API только создатель одноранговой группы может выполнить эту операцию.

 

Функции управления записями и записями

Функция Описание
PeerGroupAddRecord Добавляет новую запись в группу одноранговых узлов, которая распространяется на все участвующие одноранговые узлы.
PeerGroupDeleteRecord Удаляет запись из одноранговой группы. Его может удалить только создатель записи.
PeerGroupEnumRecords Создает перечисление записей одноранговых групп.
PeerGroupGetRecord Извлекает определенную запись группы.
PeerGroupSearchRecords Выполняет поиск базы данных локальной одноранговой группы для записей, соответствующих заданным критериям.
PeerGroupUpdateRecord Обновляет запись в определенной одноранговой группе.

 

Функции импорта и экспорта базы данных группы

Функция Описание
PeerGroupExportDatabase Экспортирует базу данных одноранговой группы в определенный файл, который можно перенести на другой компьютер и импортировать с помощью функции PeerGroupImportDatabase.
PeerGroupImportDatabase Импортирует базу данных одноранговой группы из локального файла.

 

Функции прямого подключения

Функция Описание
PeerGroupCloseDirectConnection Закрывает определенное прямое соединение между двумя однорангами.
PeerGroupEnumConnections Создает перечисление подключений, активных в данный момент на одноранговом узле.
PeerGroupOpenDirectConnection Устанавливает прямое подключение к другому одноранговой группе.
peerGroupSendData Отправляет данные члену по соседству или прямому подключению.

 

Инфраструктура групповых событий

Функция Описание
PeerGroupGetEventData Позволяет приложению извлекать данные, возвращаемые событием группировки.
PeerGroupRegisterEvent Регистрирует одноранговый узел для определенных событий группы одноранговых узлов.
PeerGroupUnregisterEvent Отменяет регистрацию однорангового узла из уведомления о событиях одноранговых узлов, связанных с предоставленным дескриптором событий.

 

Функции преобразования времени группы

Функция Описание
PeerGroupPeerTimeToUniversalTime Преобразует значение времени ссылки, поддерживаемое группой одноранговых узлов, в локализованное значение времени, подходящее для отображения на одноранговом компьютере.
PeerGroupUniversalTimeToPeerTime Преобразует значение локального времени с компьютера однорангового узла в общее значение времени группы.

 

Функции конфигурации группы

Функция Описание
PeerGroupExportConfig Экспортирует конфигурацию группы для однорангового узла в виде XML-строки, содержащей удостоверение, имя группы и GMC для удостоверения.
PeerGroupImportConfig Импортирует конфигурацию одноранговой группы для удостоверения на основе определенных параметров в предоставленной строке конфигурации XML.