PeerGroupDelete, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupDelete supprime les données locales et le certificat associés à un groupe d’homologues.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

Paramètres

[in] pwzIdentity

Pointeur vers une chaîne Unicode qui contient l’identité ouvrant le groupe d’homologues spécifié. Si ce paramètre a la valeur NULL, l’implémentation utilise l’identité obtenue à partir de PeerIdentityGetDefault.

[in] pwzGroupPeerName

Pointeur vers une chaîne Unicode qui contient le nom d’homologue du groupe d’homologues pour lequel les données sont supprimées. Ce paramètre est obligatoire. Le nom du groupe peut être obtenu en appelant PeerGroupGetProperties avant PeerGroupClose, ou en analysant l’invitation avec PeerGroupParseInvitation.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Note Si une opération de suppression échoue en raison d’une erreur de système de fichiers, l’erreur de système de fichiers appropriée est retournée.

Code de retour	Description
E_ACCESSDENIED	L’accès à la base de données du groupe d’homologues est refusé. Vérifiez que l’homologue est autorisé à effectuer cette opération. Dans ce cas, l’homologue doit être le créateur d’origine du groupe d’homologues.
E_INVALIDARG	L’un des paramètres n’est pas valide.
PEER_E_NOT_FOUND	Le groupe d’homologues est introuvable.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque la liste de contrôle d’accès est réinitialisée manuellement.

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.

Remarques

Si un groupe d’homologues est supprimé, tous les descripteurs associés à ce groupe deviennent immédiatement non valides. Il est recommandé de s’assurer que tous les handles de ce groupe sont fermés avant d’appeler cette fonction. Sinon, ces données sont supprimées de toutes les autres applications homologues en cours d’exécution qui les utilisent, ce qui peut entraîner des erreurs et une instabilité.

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

PeerGroupCreate

Partager via