PeerGraphEnumConnections 函式 (p2p.h)

PeerGraphEnumConnections 函式會建立並傳回列舉句柄，用來列舉本機節點的連接。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumConnections(
  [in]  HGRAPH    hGraph,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

[in] hGraph

對等圖形的句柄。

[in] dwFlags

要列舉的連接類型。此為必要參數。有效值是由 PEER_CONNECTION_FLAGS指定。

[out] phPeerEnum

接收列舉的句柄。使用 PeerGraphGetNextItem 來擷取實際的連線資訊。不需要此句柄時，請呼叫 PeerGraphEndEnumeration 來釋放它。

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

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

使用 PeerGraphEnumConnections 傳回的列舉句柄呼叫 PeerGraphGetNextItem 時，PeerGraphGetNextItem 會傳回PEER_CONNECTION_INFO結構。

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