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 |
---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
|
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. |
|
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 |