PeerGroupSearchRecords, fonction (p2p.h)

Article
08/25/2023

La fonction PeerGroupSearchRecords recherche dans la base de données du groupe d’homologues local les enregistrements qui correspondent aux critères fournis.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
  [in]  HGROUP    hGroup,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues dont la base de données locale fait l’objet d’une recherche. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzCriteria

Pointeur vers une chaîne XML Unicode qui contient la requête de recherche d’enregistrements. Pour plus d’informations sur la formulation d’une chaîne de requête XML pour rechercher dans la base de données d’enregistrements de groupe d’homologues, consultez la documentation Format de requête de recherche d’enregistrements . Ce paramètre est obligatoire.

[out] phPeerEnum

Pointeur vers l’énumération qui contient la liste d’enregistrements retournée. Ce handle est passé à
PeerGetNextItem pour récupérer les éléments avec chaque élément représenté en tant que pointeur vers une structure PEER_RECORD . Lorsque vous avez terminé, PeerEndEnumeration est appelé pour retourner la mémoire utilisée par l’énumération. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction 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 disponible est insuffisante pour terminer l’opération.
PEER_E_INVALID_SEARCH	La requête de recherche XML n’adhère pas à la spécification du schéma de requête de recherche.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Spécifications


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