PeerIdentityGetFriendlyName-Funktion (p2p.h)

Die Funktion PeerIdentityGetFriendlyName gibt den Anzeigenamen der Peeridentität zurück.

Syntax

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

Parameter

[in] pwzIdentity

Gibt die Peeridentität an, um einen Anzeigenamen zu erhalten.

[out] ppwzFriendlyName

Empfängt einen Zeiger auf den Anzeigenamen. Wenn ppwzFriendlyName nicht mehr erforderlich ist, ist die Anwendung dafür verantwortlich, diese Zeichenfolge durch Aufrufen von PeerFreeData frei zu geben.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Peeridentität oder Peergruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wurde.
PEER_E_NOT_FOUND	Eine Peeridentität, die dem angegebenen Namen entspricht, wurde nicht gefunden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack für Windows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

Weitere Informationen

PeerFreeData

PeerIdentitySetFriendlyName