PeerGroupSearchRecords, fonction (p2p.h)
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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire disponible est insuffisante pour terminer l’opération. |
|
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 |