Функции 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 | Импортирует файл, содержащий сведения из одноранговой базы данных графа. |
Функции служебной программы и поддержки
| Функция | Описание |
|---|---|
| одноранговойGraphEndEnumeration | Освобождает дескриптор перечисления и освобождает ресурсы, связанные с перечислением. |
| PeerGraphFreeData | Освобождает ресурсы, возвращаемые несколькими функциями API однорангового графирования. |
| PeerGraphGetItemCount | Извлекает количество элементов в перечислении. |
| PeerGraphGetNextItem | Получает следующий элемент или элементы перечисления, созданные вызовом определенных функций, которые возвращают одноранговое перечисление. |
| PeerGraphPeerTimeToUniversalTime | Преобразует значение времени ссылки, поддерживаемое одноранговым графом, в локализованное значение времени, подходящее для отображения на компьютере однорангового узла. |
| PeerGraphUniversalTimeToPeerTime | Преобразует универсальное значение времени с компьютера однорангового узла в общее значение времени графа. |
Функции подключения
| Функция | Описание |
|---|---|
| PeerGraphCloseDirectConnection | Закрывает указанное прямое подключение. |
| PeerGraphConnect | Пытается подключиться к указанному узлу в одноранговом графе. Эта функция запускает асинхронную операцию. |
| PeerGraphEnumConnections | Создает и возвращает дескриптор перечисления, используемый для перечисления подключений локального узла. |
| PeerGraphOpenDirectConnection | Позволяет приложению установить прямое соединение с узлом в одноранговом графе. Подключение можно сделать только в том случае, если узел, к которому подключается приложение, подписался на событие PEER_GRAPH_EVENT_DIRECT_CONNECTION. |
| peerGraphSendData | Отправляет данные на соседний узел или непосредственно подключенный узел. |
Функции инфраструктуры событий
| Функция | Описание |
|---|---|
| PeerGraphGetEventData | Извлекает одноранговые события. |
| PeerGraphRegisterEvent | Регистрирует запрос однорангового узла, чтобы получать уведомления об изменениях, связанных с одноранговым графом и типом событий. |
| peerGraphUnregisterEvent | Запрашивает, что приложение больше не уведомляется об изменениях, связанных с одноранговым графом и типом записей. |