PeerCreatePeerName, fonction (p2p.h)

La fonction PeerCreatePeerName crée un nom basé sur le nom existant de l’identité d’homologue et du classifieur spécifiés. Toutefois, une nouvelle identité n’est pas créée par un appel à PeerCreatePeerName.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Paramètres

[in] pwzIdentity

Spécifie l’identité à utiliser comme base pour le nouveau nom d’homologue. Si pwzIdentity a la valeur NULL, le nom créé n’est basé sur aucune identité d’homologue et est donc un nom non sécurisé.

Ce paramètre ne peut être NULL que si pwzClassifier n’est pas NULL.

[in] pwzClassifier

Pointeur vers la chaîne Unicode qui contient le nouveau classifieur. Ce classifieur est ajouté à la partie autorité existante du nom d’homologue de l’identité spécifiée. Cette chaîne contient 150 caractères, y compris la marque de fin NULL . Spécifiez NULL pour renvoyer le nom d’homologue de l’identité.

Ce paramètre ne peut être NULL que si pwzIdentity n’a pas la valeur NULL.

[out] ppwzPeerName

Pointeur qui reçoit un pointeur vers le nouveau nom d’homologue. Lorsque cette chaîne n’est plus nécessaire, libérez-la en appelant PeerFreeData.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle 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.

Remarques

Le paramètre ppwzPeername doit avoir la valeur Null avant que la fonction PeerCreatePeerName soit appelée.

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 de mise en réseau avancé pour Windows 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

PeerFreeData