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

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

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

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

 

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

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