peerGraphGetNodeInfo 函式 (p2p.h)

  • 發行項

PeerGraphGetNodeInfo 函式會擷取特定節點的相關信息。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
  [in]  HGRAPH          hGraph,
  [in]  ULONGLONG       ullNodeId,
  [out] PPEER_NODE_INFO *ppNodeInfo
);

參數

[in] hGraph

對等圖形的句柄。

[in] ullNodeId

指定應用程式接收相關信息之節點的識別碼。 指定零 (0) ，以擷取本機節點的相關信息。

[out] ppNodeInfo

接收包含所要求資訊 之PEER_NODE_INFO 結構的指標。 不需要句柄時，請呼叫 PeerGraphFreeData 來釋放它。

傳回值

如果函式成功，傳回值會 S_OK。 否則，函式會傳回下列其中一個錯誤碼。

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

備註

計算機上可以有數個圖形節點。 例如，多個使用者可能已加入特定計算機上的圖形，因此 PeerGraphGetNodeInfo 傳回的資訊與每個節點有關，而不是每部電腦。

規格需求

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

另請參閱

PEER_NODE_INFO

PeerGraphFreeData