PeerIdentityGetXML-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerIdentityGetXML-Funktion gibt eine Beschreibung der Peeridentität zurück, die dann an Dritte übergeben und verwendet werden kann, um eine Peeridentität in eine Peergruppe einzuladen. Diese Informationen werden als XML-Fragment zurückgegeben.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

Parameter

[in] pwzIdentity

Gibt die Peeridentität an, für die Peeridentitätsinformationen abgerufen werden sollen. Wenn dieser Parameter als NULL übergeben wird, wird von der Peerinfrastruktur eine "Standardidentität" für den Benutzer generiert.

[out] ppwzIdentityXML

Zeiger auf einen Zeiger auf eine Unicode-Zeichenfolge, die das XML-Fragment enthält. Wenn ppwzIdentityXML 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_HANDLE	Das Handle für die Identität ist ungültig.
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.

Hinweise

Das zurückgegebene XML-Fragment hat die folgende Struktur:

&lt;PEERIDENTITYINFO VERSION="1.0"&gt;
     &lt;IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64"&gt;
          Base 64 encoded certificate.
     &lt;/IDC&gt;
&lt;/PEERIDENTITYINFO&gt;

Dieses XML-Fragment wird beim Erstellen einer Einladung zum Beitreten zu einer Gruppe verwendet.

Anwendungen dürfen keine Tags innerhalb des PEERIDENTITYINFO-Tags hinzufügen oder dieses XML-Fragment in irgendeiner Weise ändern. Anwendungen dürfen dieses XML-Fragment in andere XML-Dokumente integrieren, müssen jedoch alle anwendungsspezifischen XML-Dateien entfernen, bevor dieses Fragment an peerGroupCreateInvitation übergeben wird.

Anforderungen


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

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation