PeerGroupSetProperties, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupSetProperties définit les propriétés actuelles du groupe d’homologues. Dans la version 1.0 de cette API, seul le créateur du groupe d’homologues peut effectuer cette opération.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues dont les propriétés sont définies par un homologue. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pProperties

Pointeur vers une structure de PEER_GROUP_PROPERTIES d’homologue qui contient les nouvelles propriétés. Pour obtenir cette structure, un homologue doit d’abord appeler PeerGroupGetProperties, modifier les champs appropriés, puis le passer en tant que paramètre. Ce paramètre est obligatoire.

Les membres suivants de PEER_GROUP_PROPERTIES ne peuvent pas être modifiés :

dwSize
pwzCloud
pwzClassifier
pwzGroupPeerName
pwzCreatorPeerName

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_OUTOFMEMORY	Il n’y a pas assez de mémoire disponible pour terminer l’opération.
PEER_E_GROUP_NOT_READY	Le groupe n’est pas dans un état où les propriétés du groupe d’homologues peuvent être définies. Par exemple, PeerGroupJoin a été 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_INVALID_GROUP_PROPERTIES	Une ou plusieurs des propriétés spécifiées ne sont pas valides.
PEER_E_NOT_AUTHORIZED	L’identité actuelle n’a pas l’autorisation de modifier ces propriétés. Dans ce cas, l’identité n’est pas le créateur du groupe d’homologues.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	Le mot de passe spécifié ne répond pas aux exigences de mot de passe système.

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.

Remarques

Pour les applications qui utilisent des mots de passe, il est recommandé que les mots de passe soient gérés de manière sécurisée en appelant les fonctions CryptoProtectMemory et SecureZeroMemory .

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