PeerGraphEnumRecords 関数 (p2p.h)

  • [アーティクル]

PeerGraphEnumRecords 関数は、特定の種類のレコード、ユーザー、またはその両方のレコードを列挙するために使用される列挙ハンドルを作成して返します。 列挙体は、列挙の実行時にレコードのスナップショットを提供します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

パラメーター

[in] hGraph

ピア グラフへの処理。

[in] pRecordType

列挙するレコードの種類へのポインター。 すべてのレコードの種類を列挙するには 、NULL を 指定します。

[in] pwzPeerId

アプリケーションが列挙を要求している作成者を識別する文字列へのポインター。 すべてのレコードを列挙するには 、NULL を指定します 。

[out] phPeerEnum

列挙へのハンドルを受け取ります。 PeerGraphGetNextItem のすべての呼び出しにハンドルを指定します。 ハンドルが必要ない場合は、 PeerGraphEndEnumeration を呼び出して解放します。

戻り値

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

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

注釈

  • pRecordType パラメーターと pwzPeerId パラメーターの両方が NULL の場合、すべてのレコードが返されます。
  • 単純な列挙タスクの場合は、 PeerGraphSearchRecords 関数よりも効率的であるため、PeerGraphEnumRecords 関数 を 使用します。 データベースのヒューリスティック検索などの複雑な列挙およびフィルター処理タスクの場合は、 PeerGraphSearchRecords 関数を使用します。
  • PeerGraphGetNextItem が PeerGraphEnumRecords が返すハンドルを使用して呼び出されると、PeerGraphGetNextItem はPEER_RECORD構造体のデータを返します。

要件

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

こちらもご覧ください

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords