Partager via


PeerGroupGetRecord, fonction (p2p.h)

La fonction PeerGroupGetRecord récupère un enregistrement de groupe spécifique.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Paramètres

[in] hGroup

Gérez vers un groupe qui contient un enregistrement spécifique. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pRecordId

Spécifie la valeur GUID qui identifie de manière unique un enregistrement obligatoire au sein d’un groupe d’homologues. Ce paramètre est obligatoire.

[out] ppRecord

Pointeur vers l’adresse d’une structure de PEER_RECORD qui contient un enregistrement retourné. Cette structure est libérée en passant son pointeur vers PeerFreeData. 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 est insuffisante pour effectuer l’opération spécifiée.
PEER_E_GROUP_NOT_READY
Le groupe d’homologues n’est pas dans un état où les enregistrements de groupe peuvent être récupérés. Par exemple, PeerGroupJoin est appelé, mais la synchronisation avec la base de données de groupe d’homologues n’est pas terminée.
PEER_E_INVALID_GROUP
Le handle d’un groupe d’homologues n’est pas valide.
PEER_E_RECORD_NOT_FOUND
Impossible de trouver un enregistrement qui correspond à l’ID fourni dans une base de données de groupe d’homologues.
 

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont précédées de 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 réseau avancé pourWindows 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

Voir aussi

PEER_RECORD

PeerFreeData

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupJoin

PeerGroupOpen