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

Статья
08/25/2023

Функция PeerGroupRegisterEvent регистрирует одноранговый узел для определенных событий группы одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupRegisterEvent(
  [in]  HGROUP                        hGroup,
  [in]  HANDLE                        hEvent,
  [in]  DWORD                         cEventRegistration,
  [in]  PEER_GROUP_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Параметры

[in] hGroup

Дескриптор одноранговой группы, в которой необходимо отслеживать события конкретного однорангового узла. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] hEvent

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

[in] cEventRegistration

Содержит количество PEER_GROUP_EVENT_REGISTRATION структур, перечисленных в pEventRegistrations. Это обязательный параметр.

[in] pEventRegistrations

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

[out] phPeerEvent

Указатель на возвращенный дескриптор HPEEREVENT. Одноранговый узел может отменить регистрацию для этого однорангового события, передав этот дескриптор в PeerGroupUnregisterEvent. Это обязательный параметр.

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
PEER_E_INVALID_GROUP	Дескриптор группы недопустим.

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

Требования

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