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

アプリケーションが情報を受信するノードの ID を指定します。 ローカル ノードに関する情報を取得するには、ゼロ (0) を指定します。

[out] ppNodeInfo

要求された情報を含む PEER_NODE_INFO 構造体へのポインターを受け取ります。 ハンドルが必要ない場合は、 PeerGraphFreeData を呼び出して解放します。

戻り値

関数が成功した場合、戻り値は S_OK。 それ以外の場合、関数は次のいずれかのエラー コードを返します。

リターン コード 説明
E_INVALIDARG
 1 つのパラメーターが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_INVALID_GRAPH
 ピア グラフへのハンドルが無効です。
PEER_E_NOT_INITIALIZED
 ピア グラフは、この関数を使用する前に PeerGraphStartup の呼び出しを使用して初期化する必要があります。
PEER_E_NODE_NOT_FOUND
 指定したノードが見つかりません。

注釈

コンピューターには、グラフのいくつかのノードが存在する可能性があります。 たとえば、複数のユーザーが特定のコンピューターでグラフに参加している可能性があるため、 PeerGraphGetNodeInfo が返す情報は各ノードに関する情報であり、各コンピューターに関する情報ではありません。

要件

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

こちらもご覧ください

PEER_NODE_INFO

PeerGraphFreeData