Функция PeerGraphCreate (p2p.h)

Статья
08/25/2023

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

Параметры

[in] pGraphProperties

Все свойства однорангового графа в структуре PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

Имя базы данных записей, связываемой с одноранговым графом при ее создании. Имя базы данных записей должно быть допустимым именем файла. Не включайте путь с именем файла. Полный список правил, касающихся имен файлов, см. в разделе Именование элемента File в списке graphing Reference_Links.

[in] pSecurityInterface

Сведения о поставщике безопасности для однорангового графа в структуре PEER_SECURITY_INTERFACE .

[out] phGraph

Получает дескриптор созданного однорангового графа. Если этот дескриптор больше не требуется, освободите его, вызвав PeerGraphClose.

Возвращаемое значение

Возвращает S_OK , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_DUPLICATE_GRAPH	База данных с указанным идентификатором графа однорангового узла, который уже существует.
PEER_E_NOT_INITIALIZED	Одноранговый граф необходимо инициализировать с помощью вызова PeerGraphStartup , прежде чем использовать эту функцию.

При разработке собственного поставщика служб безопасности (SSP) приложение не должно вызывать API однорангового графирования для доступа к данным в одноранговой базе данных графов, так как это может привести к взаимоблокировке. Вместо этого приложение должно использовать кэшированную копию сведений. Кэшированная копия не создается API однорангового графирования. Приложение должно предоставить механизм кэширования этих данных.

После вызова PeerGraphCreate приложение может подписаться на события перед вызовом PeerGraphListen.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2PGraph.lib
DLL	P2PGraph.dll