Share via

peerGraphRegisterEvent 函式 (p2p.h)

  • 發行項

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

指定 pEventRegistrations 中的PEER_GRAPH_EVENT_REGISTRATION結構數目。

[in] pEventRegistrations

指向 PEER_GRAPH_EVENT_REGISTRATION 結構的陣列，指定應用程式要求通知的事件。

[out] phPeerEvent

接收 HPEEREVENT 句柄。 呼叫 PeerGraphUnregisterEvent 停止接收通知時，必須使用這個句柄。

傳回值

如果函式呼叫成功，傳回值會S_OK。 否則，它會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_INVALID_GRAPH
 對等圖形的句柄無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先呼叫 PeerGraphStartup 來初始化對等圖形。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2PGraph.lib
Dll P2PGraph.dll

另請參閱

PEER_GRAPH_EVENT_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent