Freigeben über


PeerCollabSetEndpointName-Funktion (p2p.h)

Die PeerCollabSetEndpointName-Funktion legt den Namen des aktuellen Endpunkts fest, der von der Peeranwendung verwendet wird.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetEndpointName(
  [in] PCWSTR pwzEndpointName
);

Parameter

[in] pwzEndpointName

Zeiger auf den neuen Namen des aktuellen Endpunkts, dargestellt als unicode-Zeichenfolge mit Nullzeichen. Ein Fehler wird ausgelöst, wenn der neue Name mit dem aktuellen Namen identisch ist. Ein Endpunktname ist auf 255 Unicode-Zeichen beschränkt.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode Beschreibung
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen.
E_INVALIDARG
Eines der Argumente ist ungültig.
PEER_E_NOT_SIGNED_IN
Für den Vorgang muss der Benutzer angemeldet sein.

Hinweise

Ein Endpunktname ist standardmäßig auf den Computernamen festgelegt. Ein neuer Endpunktname, der von der Funktion PeerCollabSetEndpointName festgelegt wird, wird jedoch über Neustarts hinweg beibehalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile p2p.h
Bibliothek P2P.lib
DLL P2P.dll

Weitere Informationen

Peerzusammenarbeits-API-Funktionen