PeerIdentityExport-Funktion (p2p.h)

Artikel
03/04/2024

Mit der Funktion PeerIdentityExport kann ein Benutzer eine Peeridentität exportieren. Der Benutzer kann dann die Peeridentität auf einen anderen Computer übertragen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityExport(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzExportXML
);

Parameter

[in] pwzIdentity

Gibt die zu exportierende Peeridentität an. Dieser Parameter ist erforderlich und verfügt nicht über einen Standardwert.

[in] pwzPassword

Gibt das Kennwort an, das zum Verschlüsseln der Peeridentität verwendet werden soll. Dieser Parameter darf nicht NULL sein. Dieses Kennwort muss auch zum Importieren der Peeridentität verwendet werden, andernfalls schlägt der Importvorgang fehl.

[out] ppwzExportXML

Empfängt einen Zeiger auf die exportierte Peeridentität im XML-Format. Wenn der Exportvorgang erfolgreich ist, muss die Anwendung ppwzExportXML durch Aufrufen von PeerFreeData freigeben.

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_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Peeridentität oder peergruppenschlüssel wurde 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.
PEER_E_NOT_FOUND	Die angegebene Peeridentität ist nicht vorhanden.

Hinweise

Die Anmeldeinformationen für die Peer-zu-Peer-Gruppenmitgliedschaft werden nicht exportiert. Es wird nur eine Peeridentität exportiert. Eine exportierte Peeridentität kann mithilfe von PeerIdentityImport auf einem anderen Computer importiert werden.

Beim Exportieren einer Peeridentität wird sie nicht aus einem lokalen ccmputer entfernt, es wird eine Kopie davon erstellt. Die Kopie kann zum Sichern und Wiederherstellen einer Peeridentität verwendet werden.

Das von PeerIdentityExport verwendete XML-Fragment lautet wie folgt:

<PEERIDENTITYEXPORT VERSION="1.0">
   <PEERNAME>
     <!-- UTF-8 encoded peer name of the identity -->
   </PEERNAME>
   <DATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </DATA>
</PEERIDENTITYEXPORT>

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

Weitere Informationen

PEER_DATA

PeerFreeData

PeerIdentityImport

Freigeben über