PeerGroupGetRecord, fonction (p2p.h)

Article
08/25/2023

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