PeerGraphSearchRecords 関数 (p2p.h)

PeerGraphSearchRecords 関数は、ピアグラフで特定のレコードを検索します。

構文

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

[in] hGraph

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

[in] pwzCriteria

検索するレコードを指定する XML 文字列へのポインター。ピアグラフレコードを検索するための XML クエリ文字列の作成については、「レコード検索クエリ形式」を参照してください。

[out] phPeerEnum

列挙体へのハンドル。

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

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_INVALID_GRAPH	ピアグラフへのハンドルが無効です。
PEER_E_INVALID_SEARCH	指定したクエリが検索スキーマに準拠していません。詳細については、「レコード検索クエリ形式」を参照してください。
PEER_E_NOT_INITIALIZED	この関数を使用する前に、ピアグラフを PeerGraphStartup の呼び出しで初期化する必要があります。

PeerGraphEnumRecords 関数は、PeerGraphSearchRecords 関数よりも効率的です。

PeerGraphGetNextItem が PeerGraphSearchRecords によって返されるハンドルを使用して呼び出されると、PeerGraphGetNextItem はPEER_RECORD構造体のデータを返します。

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