PeerIdentitySetFriendlyName-Funktion (p2p.h)
Die Funktion PeerIdentitySetFriendlyName ändert den Anzeigenamen für eine angegebene Peeridentität. Der Anzeigename ist der lesbare Name.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzFriendlyName
);
Parameter
[in] pwzIdentity
Gibt eine zu ändernde Peeridentität an.
[in] pwzFriendlyName
Gibt einen neuen Anzeigenamen an. Geben Sie NULL oder eine leere Zeichenfolge an, um einen Anzeigenamen auf den Standardwert zurückzusetzen, der unicode-Version des Peernamens.
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 einem angegebenen Namen entspricht, kann nicht gefunden werden. |
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 |