PeerGraphEnumNodes 関数 (p2p.h)

  • [アーティクル]

PeerGraphEnumNodes 関数は、ピア グラフ内のノードを列挙するために使用される列挙ハンドルを作成して返します。 列挙は、列挙が実行されるときにピア グラフのスナップショットを提供します。 ピア グラフのポリシーに応じて、ノードがプレゼンス情報を公開しない場合、列挙体はピア グラフに接続されている一部のノードを返しません。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

パラメーター

[in] hGraph

ピア グラフへのハンドル。

[in] pwzPeerId

ノード列挙を取得するピア ID。 ピア グラフ内のすべてのノードを返すには 、NULL を 指定します。

[out] phPeerEnum

列挙型へのハンドルを受け取ります。 PeerGraphGetNextItem を使用して、実際のノード情報を取得します。 このハンドルが必要ない場合は、 PeerGraphEndEnumeration を呼び出して解放します。

戻り値

関数呼び出しが成功した場合、戻り値は S_OK。 それ以外の場合は、次のいずれかの値を返します。

リターン コード 説明
E_INVALIDARG
 1 つのパラメーターが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_INVALID_GRAPH
 ピア グラフへのハンドルが無効です。
PEER_E_NOT_INITIALIZED
 この関数を使用する前に、ピア グラフを PeerGraphStartup の呼び出しで初期化する必要があります。
PEER_E_NOT_READY
 ピア グラフは完全には同期されず、ノードを列挙することはできません。
PEER_E_PRESENCE_DISABLED
 ピア グラフでは、プレゼンス情報は必要ありません。 したがって、ノードを列挙することはできません。

注釈

PeerGraphEnumNodes が返すハンドルを使用して PeerGraphGetNextItem が呼び出された場合、PeerGraphGetNextItem はPEER_NODE_INFO構造体のデータを返します。

要件

要件 値
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2PGraph.lib
[DLL] P2PGraph.dll

こちらもご覧ください

PEER_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem