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

Статья
03/05/2024

Функция PeerGraphRegisterEvent регистрирует запрос однорангового узла, чтобы получать уведомления об изменениях, связанных с одноранговым графом и типом события.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphRegisterEvent(
  [in]  HGRAPH                        hGraph,
  [in]  HANDLE                        hEvent,
  [in]  ULONG                         cEventRegistrations,
  [in]  PEER_GRAPH_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Параметры

[in] hGraph

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

[in] hEvent

Дескриптор, созданный с помощью CreateEvent , на который приложение получает сигнал при активации события. Когда приложение получает сигнал, оно должно вызывать PeerGraphGetEventData для получения событий до тех пор, пока не будет возвращено PEER_S_NO_EVENT_DATA.

[in] cEventRegistrations

Указывает количество PEER_GRAPH_EVENT_REGISTRATION структур в pEventRegistrations.

[in] pEventRegistrations

Указывает на массив структур PEER_GRAPH_EVENT_REGISTRATION , указывающих, для каких событий приложение запрашивает уведомления.

[out] phPeerEvent

Получает дескриптор HPEEREVENT . Этот дескриптор необходимо использовать при вызове PeerGraphUnregisterEvent , чтобы прекратить получение уведомлений.

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

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

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

Требования

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

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

PEER_GRAPH_EVENT_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent

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