PeerGroupGetProperties, fonction (p2p.h)

Article
03/01/2024

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