PeerGroupDeleteRecord, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGroupDeleteRecord supprime un enregistrement d’un groupe d’homologues. Le créateur, ainsi que tout autre membre d’un rôle d’administration, peuvent supprimer un enregistrement spécifique.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDeleteRecord(
  [in] HGROUP     hGroup,
  [in] const GUID *pRecordId
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues qui contient l’enregistrement. 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 l’enregistrement à supprimer. 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
PEER_E_GROUP_NOT_READY	Le groupe d’homologues n’est pas dans un état où les enregistrements peuvent être supprimé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 du groupe d’homologues n’est pas valide.
PEER_E_NOT_AUTHORIZED	L’identité actuelle n’a pas l’autorisation de supprimer l’enregistrement. Dans ce cas, l’identité n’est pas le créateur ou un membre dans un rôle d’administration peut supprimer un enregistrement spécifique.
PEER_E_RECORD_NOT_FOUND	L’enregistrement ne peut pas se trouver dans le magasin de données.

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.

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 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

Voir aussi

PeerGroupUpdateRecord