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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer une opération spécifiée. |
|
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. |
|
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 |