PeerCreatePeerName-Funktion (p2p.h)

Die PeerCreatePeerName-Funktion erstellt einen neuen Namen basierend auf dem vorhandenen Namen der angegebenen Peeridentität und -klassifizierer. Eine neue Identität wird jedoch nicht durch einen Aufruf von PeerCreatePeerName erstellt.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Parameter

[in] pwzIdentity

Gibt die Identität an, die als Grundlage für den neuen Peernamen verwendet werden soll. Wenn pwzIdentityNULL ist, basiert der erstellte Name nicht auf einer Peeridentität und ist daher ein ungesicherter Name.

Dieser Parameter kann nur NULL sein, wenn pwzClassifier nicht NULL ist.

[in] pwzClassifier

Zeiger auf die Unicode-Zeichenfolge, die den neuen Klassifizierer enthält. Dieser Klassifizierer wird an den vorhandenen Autoritätsteil des Peernamens der angegebenen Identität angefügt. Diese Zeichenfolge ist 150 Zeichen lang, einschließlich des NULL-Abschlusszeichens . Geben Sie NULL an, um den Peernamen der Identität zurückzugeben.

Dieser Parameter kann nur NULL sein, wenn pwzIdentity nicht NULL ist.

[out] ppwzPeerName

Zeiger, der einen Zeiger auf den neuen Peernamen empfängt. Wenn diese Zeichenfolge nicht mehr benötigt wird, geben Sie sie durch Aufrufen von PeerFreeData frei.

Rückgabewert

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

Hinweise

Der Parameter ppwzPeername muss auf NULL festgelegt werden, bevor die PeerCreatePeerName-Funktion aufgerufen wird.

Anforderungen

Weitere Informationen

PeerFreeData