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。 それ以外の場合、関数は次のいずれかのエラー コードを返します。
リターン コード | 説明 |
---|---|
|
1 つのパラメーターが無効です。 |
|
指定した操作を実行するのに十分なメモリがありません。 |
|
ピア グラフへのハンドルが無効です。 |
|
ピア グラフは、この関数を使用する前に PeerGraphStartup の呼び出しを使用して初期化する必要があります。 |
|
指定したノードが見つかりません。 |
注釈
コンピューターには、グラフのいくつかのノードが存在する可能性があります。 たとえば、複数のユーザーが特定のコンピューターでグラフに参加している可能性があるため、 PeerGraphGetNodeInfo が返す情報は各ノードに関する情報であり、各コンピューターに関する情報ではありません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | p2p.h |
Library | P2PGraph.lib |
[DLL] | P2PGraph.dll |