PeerIdentitySetFriendlyName, fonction (p2p.h)

Article
03/01/2024

La fonction PeerIdentitySetFriendlyName modifie le nom convivial d’une identité d’homologue spécifiée. Le nom convivial est le nom lisible par l’utilisateur.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzFriendlyName
);

Paramètres

[in] pwzIdentity

Spécifie une identité d’homologue à modifier.

[in] pwzFriendlyName

Spécifie un nouveau nom convivial. Spécifiez NULL ou une chaîne vide pour réinitialiser un nom convivial à la valeur par défaut, qui est la version Unicode du nom d’homologue.

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.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.
PEER_E_NOT_FOUND	Une identité d’homologue qui correspond à un nom spécifié est introuvable.

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

PeerIdentityGetFriendlyName

Partager via