Функция PeerGroupStartup (p2p.h)
Функция PeerGroupStartup инициирует одноранговую группу, используя запрошенную версию инфраструктуры одноранговых узлов.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
[in] WORD wVersionRequested,
[out] PPEER_VERSION_DATA pVersionData
);
Параметры
[in] wVersionRequested
Указывает самую высокую версию одноранговой инфраструктуры, которую может поддерживать вызывающий объект. В байте высокого порядка указывается дополнительный номер версии (редакции). Байт нижнего порядка указывает номер основной версии. Этот параметр является обязательным.
[out] pVersionData
Указатель на структуру PEER_VERSION_DATA , которая содержит определенный уровень поддержки, предоставляемый одноранговой инфраструктурой. Это обязательный параметр.
Возвращаемое значение
Возвращает S_OK , если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Перед вызовомPeerGroupStartup необходимо запустить службу PNRP. |
|
Недостаточно памяти для завершения операции. |
|
Не удалось запустить службу группирования, так как на компьютере не установлен протокол IPv6. |
|
Запрошенная версия не поддерживается установленной подсистемой однорангового узла. |
Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.
Комментарии
Перед вызовом этой функции необходимо запустить службу PNRP .
Эта функция вызывается приложением перед вызовом любой другой функции однорангового группирования.
В этом выпуске приложения должны использовать PEER_GROUP_VERSION в качестве запрошенной версии.
Одноранговая группа, запущенная с этой функцией, закрывается путем вызова PeerGroupShutdown при завершении работы приложения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |