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


Функции API graphing

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

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

Функция Описание
PeerGraphShutdown Очищает все ресурсы, выделенные вызовом PeerGraphStartup.
PeerGraphStartup Указывает инфраструктуре однорангового графирования, какую версию протоколов одноранговых узлов требуется вызывающей приложению.

 

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

Функция Описание
PeerGraphClose Делает недействительным дескриптор однорангового графа, возвращенный вызовом PeerGraphCreate или PeerGraphOpen, и закрывает все сетевые подключения для указанного однорангового графа.
PeerGraphCreate Создает новый одноранговый граф.
PeerGraphDelete Удаляет данные, связанные с указанным одноранговым графом.
PeerGraphListen Указывает, что одноранговый граф должен начать прослушивание входящих подключений.
PeerGraphOpen Открывает одноранговый граф, созданный ранее локальным или удаленным узлом.

 

Функции сведений о графе и узле

Функция Описание
PeerGraphEnumNodes Создает и возвращает дескриптор перечисления, используемый для перечисления узлов в одноранговом графе.
PeerGraphGetNodeInfo Извлекает сведения об определенном узле.
PeerGraphGetProperties Извлекает текущие свойства однорангового графа.
PeerGraphGetStatus Возвращает текущее состояние однорангового графа.
PeerGraphSetNodeAttributes Задает атрибуты структуры PEER_NODE_INFO для локального узла.
PeerGraphSetPresence Явным образом включает или отключает публикацию записей о присутствии для определенного узла. Эта функция может переопределять параметры присутствия в свойствах однорангового графа.
PeerGraphSetProperties Задает свойства однорангового графа.

 

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

Функция Описание
PeerGraphAddRecord Добавляет новую запись в одноранговый граф. Запись, добавленная с помощью этой функции, отправляется на каждый узел в одноранговом графе.
PeerGraphDeleteRecord Помечает запись как удаленную в одноранговом графе.
PeerGraphEnumRecords Создает и возвращает дескриптор перечисления, используемый для перечисления записей определенного типа записи, пользователя или и того, и другого.
PeerGraphGetRecord Извлекает определенную запись на основе указанного идентификатора записи.
PeerGraphSearchRecords Выполняет поиск определенных записей в одноранговом графе.
PeerGraphUpdateRecord Обновления запись в одноранговом графе, а затем перенаправляет ее на каждый узел однорангового графа.
PeerGraphValidateDeferredRecords Указывает инфраструктуре однорангового графирования, что пора повторно отправить отложенные записи для проверки модуля безопасности.

 

Функции экспорта и импорта

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

 

Служебные и вспомогательные функции

Функция Описание
PeerGraphEndEnumeration Освобождает дескриптор перечисления и освобождает ресурсы, связанные с перечислением.
PeerGraphFreeData Освобождает ресурсы, возвращаемые некоторыми функциями API однорангового графирования.
PeerGraphGetItemCount Извлекает количество элементов в перечислении.
PeerGraphGetNextItem Получает следующий элемент или элементы в перечислении, созданном вызовом определенных функций, которые возвращают одноранговые перечисления.
PeerGraphPeerTimeToUniversalTime Преобразует значение времени, поддерживаемое графиком однорангового узла, в локализованное значение времени, подходящее для отображения на компьютере однорангового узла.
PeerGraphUniversalTimeToPeerTime Преобразует универсальное значение времени с компьютера однорангового узла в общее значение времени графа однорангового узла.

 

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

Функция Описание
PeerGraphCloseDirectConnection Закрывает указанное прямое соединение.
PeerGraphConnect Пытается установить соединение с указанным узлом в одноранговом графе. Эта функция запускает асинхронную операцию.
PeerGraphEnumConnections Создает и возвращает дескриптор перечисления, используемый для перечисления подключений локального узла.
PeerGraphOpenDirectConnection Позволяет приложению устанавливать прямое соединение с узлом в одноранговом графе. Подключение может быть установлено только в том случае, если узел, к которому подключается приложение, подписался на событие PEER_GRAPH_EVENT_DIRECT_CONNECTION .
PeerGraphSendData Отправляет данные на соседний узел или непосредственно подключенный узел.

 

Функции инфраструктуры событий

Функция Описание
PeerGraphGetEventData Извлекает одноранговые события.
PeerGraphRegisterEvent Регистрирует запрос однорангового узла для уведомления об изменениях, связанных с одноранговым графом и типом события.
PeerGraphUnregisterEvent Запрашивает, чтобы приложение больше не уведомлялось об изменениях, связанных с одноранговым графом и типом записи.