Функции 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. |