PeerIdentitySetFriendlyName, fonction (p2p.h)
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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération spécifiée. |
|
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. |
|
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 |