Partager via


PeerGraphSearchRecords, fonction (p2p.h)

La fonction PeerGraphSearchRecords recherche des enregistrements spécifiques dans le graphe homologue.

Syntaxe

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

Paramètres

[in] hGraph

Gérez le graphe d’homologue.

[in] pwzCriteria

Pointeur vers une chaîne XML qui spécifie les enregistrements à rechercher. Pour plus d’informations sur la formulation d’une chaîne de requête XML pour rechercher les enregistrements graphiques d’homologues, consultez Format de requête de recherche d’enregistrements.

[out] phPeerEnum

Gérez l’énumération.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour Description
E_INVALIDARG
L’un des paramètres n’est pas valide.
E_OUTOFMEMORY
La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_INVALID_GRAPH
Le handle du graphe d’homologue n’est pas valide.
PEER_E_INVALID_SEARCH
La requête spécifiée n’adhère pas au schéma de recherche. Pour plus d’informations, consultez Format de requête de recherche d’enregistrement.
PEER_E_NOT_INITIALIZED
Le graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

La fonction PeerGraphEnumRecords est plus efficace que la fonction PeerGraphSearchRecords .

Lorsque PeerGraphGetNextItem est appelé avec le handle retourné par PeerGraphSearchRecords, PeerGraphGetNextItem retourne les données dans la structure PEER_RECORD .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête p2p.h
Bibliothèque P2PGraph.lib
DLL P2PGraph.dll

Voir aussi

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphEnumRecords

PeerGraphGetItemCount

PeerGraphGetNextItem