peerGraphGetEventData 函式 (p2p.h)

PeerGraphGetEventData 函式會擷取對等事件。應用程式會呼叫此函式，直到 傳回PEER_S_NO_EVENT_DATA 傳回值為止，這表示呼叫成功，但沒有其他要擷取的對等事件。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GRAPH_EVENT_DATA *ppEventData
);

[in] hPeerEvent

對等事件句柄，由對 PeerGraphRegisterEvent 的呼叫所取得。

[out] ppEventData

接收包含事件通知相關數據的 PEER_GRAPH_EVENT_DATA 結構的指標。不需要此結構時，請呼叫 PeerGraphFreeData 來釋放它。

如果函數調用成功，傳回值會 S_OK。否則，它會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_S_NO_EVENT_DATA	函數調用成功，但沒有與對等事件相關聯的數據。
PEER_E_NOT_INITIALIZED	使用這個函式之前，必須先使用對PeerGraphStartup 的呼叫來初始化對等圖形。

對等事件數據會在 PEER_GRAPH_EVENT_DATA 結構中傳回。 PEER_GRAPH_EVENT_DATA所指向的數據結構類型取決於觸發的事件。

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