PeerIdentityGetFriendlyName, fonction (p2p.h)

Article
03/01/2024

La fonction PeerIdentityGetFriendlyName retourne le nom convivial de l’identité d’homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

Paramètres

[in] pwzIdentity

Spécifie l’identité d’homologue pour obtenir un nom convivial.

[out] ppwzFriendlyName

Reçoit un pointeur vers le nom convivial. Lorsque ppwzFriendlyName n’est plus requis, l’application est responsable de libérer cette chaîne en appelant PeerFreeData.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il 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 incorrecte pour le dossier qui contient les clés utilisateur ou ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.
PEER_E_NOT_FOUND	Une identité d’homologue qui correspond au 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

PeerFreeData

PeerIdentitySetFriendlyName

Partager via