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

Статья
08/25/2023

Функция PeerGroupStartup инициирует одноранговую группу, используя запрошенную версию инфраструктуры одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

Параметры

[in] wVersionRequested

Указывает самую высокую версию одноранговой инфраструктуры, которую может поддерживать вызывающий объект. В байте высокого порядка указывается дополнительный номер версии (редакции). Байт нижнего порядка указывает номер основной версии. Этот параметр является обязательным.

[out] pVersionData

Указатель на структуру PEER_VERSION_DATA , которая содержит определенный уровень поддержки, предоставляемый одноранговой инфраструктурой. Это обязательный параметр.

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

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

Код возврата	Описание
ERROR_SERVICE_DEPENDENCY_FAIL	Перед вызовом PeerGroupStartup необходимо запустить службу PNRP.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
PEER_E_IPV6_NOT_INSTALLED	Не удалось запустить службу группирования, так как на компьютере не установлен протокол IPv6.
PEER_E_UNSUPPORTED_VERSION	Запрошенная версия не поддерживается установленной подсистемой однорангового узла.

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Требования

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

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

Функции API группирования

PEER_VERSION_DATA

PeerGroupShutdown

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