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 |
---|---|
|
一個參數無效。 |
|
記憶體不足,無法執行指定的作業。 |
|
函數調用成功,但沒有與對等事件相關聯的數據。 |
|
使用這個函式之前,必須先使用 對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 |