PeerGroupCreate, fonction (p2p.h)

  • Article

La fonction PeerGroupCreate crée un groupe d’homologues.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Paramètres

[in] pProperties

Pointeur vers une structure de PEER_GROUP_PROPERTIES qui spécifie les détails spécifiques du groupe, tels que les noms de groupes d’homologues, les durées de vie des invitations et les durées de vie de présence. Ce paramètre est obligatoire.

Les membres suivants doivent être définis :

  • pwzCreatorPeerName

Les membres suivants ne peuvent pas être définis :

  • pwzGroupPeerName
Les autres membres sont facultatifs.

[out] phGroup

Retourne le pointeur de handle vers le groupe d’homologues. Toute fonction appelée avec ce handle en tant que paramètre a l’action correspondante effectuée sur ce groupe d’homologues. 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 l’opération spécifiée.
PEER_E_CLOUD_NAME_AMBIGUOUS
 Le cloud spécifié dans pProperties ne peut pas être découvert de manière unique (plusieurs clouds correspondent au nom fourni).
PEER_E_INVALID_CLASSIFIER
 Le classifieur de groupe d’homologues spécifié dans pProperties n’est pas valide.
PEER_E_INVALID_PEER_NAME
 Le nom d’homologue spécifié pour le groupe dans pProperties n’est pas valide.
PEER_E_INVALID_PROPERTIES
 Une ou plusieurs des propriétés de groupe d’homologues fournies dans pProperties ne sont pas valides.
PEER_E_NO_CLOUD
 Impossible de localiser le cloud spécifié dans pProperties .
PEER_E_NO_KEY_ACCESS
 L’accès aux clés d’identité ou de groupe est refusé. En règle générale, cela est dû à une liste de contrôle d’accès incorrecte pour le dossier qui contient les clés utilisateur ou ordinateur. Cela peut se produire lorsque l’ACL est réinitialisée manuellement.
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.
ERROR_DELETE_PENDING
 L’identité d’homologue spécifiée comme créateur de groupe a été supprimée ou est en cours de suppression.
 

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

PeerGroupConnect doit être appelé par le créateur du groupe immédiatement après la création. Si cela n’a pas lieu, les utilisateurs ayant reçu une invitation appellent PeerGroupConnect correctement, mais ils ne pourront pas écouter et recevront l’événement d’échec de connexion.

Une application obtient une identité en appelant PeerIdentityCreate ou toute autre méthode qui retourne une chaîne de nom d’identité. Cette identité sert de propriétaire du groupe et est le membre initial du groupe d’homologues lors de sa création.

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

Voir aussi

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen