PeerGraphSearchRecords, fonction (p2p.h)

Article
03/04/2024

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