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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Параметры

[in] hGraph

Дескриптор однорангового графа.

[in] pRecord

Указатель на добавляемую запись.

[out] pRecordId

Указывает идентификатор записи, однозначно идентифицирующий запись в одноранговом графе.

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

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

Код возврата Описание
E_ACCESSDENIED
 Не удается получить доступ к одноранговой диаграмме.
E_INVALIDARG
 Один из параметров недопустим.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения указанной операции.
PEER_E_GRAPH_NOT_READY
 Граф не синхронизирован. Записи нельзя добавить, пока одноранговый граф не будет синхронизирован.
PEER_E_GRAPH_SHUTTING_DOWN

Метод PeerGraphClose был вызван.
PEER_E_INVALID_ATTRIBUTES
 Указанные атрибуты не соответствуют схеме.
PEER_E_INVALID_GRAPH
 Дескриптор однорангового графа недопустим.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 Размер записи превышает максимальный размер однорангового графа.
PEER_E_NOT_INITIALIZED
 Прежде чем использовать эту функцию, граф необходимо инициализировать с помощью вызова PeerGraphStartup.

Комментарии

Следующие элементы структуры PEER_RECORD должны содержать допустимые значения:

  • dwSize.
  • type.
  • ftExpiration — должен быть позже текущего времени графа и указываться в одноранговом времени с помощью PeerGraphUniversalTimeToPeerTime.
Следующие элементы структуры PEER_RECORD являются необязательными. Задайте для них значение NULL , если они не используются приложением:
  • data
  • pwzAttributes
  • securityData
  • dwVersion
Если любой из следующих элементов имеет значение NULL, API однорангового графирования выполняет указанное поведение по умолчанию:
  • pwzCreatorId — использует идентификатор однорангового узла, переданный в PeerGraphCreate или PeerGraphOpen.
  • pwzModifiedById — использует pwzCreatorId.
Невозможно указать следующие члены: Любое используемое значение перезаписывается инфраструктурой однорангового графирования:
  • id.
  • ftCreation — использует одноранговую связь.
  • ftLastModified — использует одноранговую связь.

Требования

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

См. также раздел

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate