Partager via


PeerGroupGetProperties, fonction (p2p.h)

La fonction PeerGroupGetProperties récupère des informations sur les propriétés d’un groupe spécifié.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

Paramètres

[in] hGroup

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

[out] ppProperties

Pointeur vers une structure de PEER_GROUP_PROPERTIES qui contient des informations sur les propriétés du groupe d’homologues. Ces données doivent être libérées avec 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 une opération spécifiée.
PEER_E_GROUP_NOT_READY
Le groupe n’est pas dans un état où les propriétés du groupe d’homologues peuvent être récupérées. Par exemple, PeerGroupJoin est appelé, mais la synchronisation avec la base de données de groupe n’est pas terminée.
PEER_E_INVALID_GROUP
Le handle du groupe d’homologues n’est pas valide.
 

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

Les propriétés de groupe ne peuvent pas être récupérées si un homologue n’a pas été synchronisé avec une base de données de groupe d’homologues. Pour synchroniser avec une base de données de groupe d’homologues avant d’appeler cette fonction, appelez d’abord PeerGroupConnect.

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

Voir aussi

PEER_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupSetProperties