PeerIdentityImport-Funktion (p2p.h)

Artikel
03/04/2024

Die PeerIdentityImport-Funktion importiert eine Peeridentität. Wenn die Peeridentität auf einem Computer vorhanden ist, wird PEER_E_ALREADY_EXISTS zurückgegeben.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityImport(
  [in]  PCWSTR pwzImportXML,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzIdentity
);

Parameter

[in] pwzImportXML

Zeiger auf die zu importierende Peeridentität im XML-Format, die von PeerIdentityExport zurückgegeben wird. Diese Binärdaten müssen mit dem exportierten Datenbyte für Byte übereinstimmen. Der XML-Code muss ohne zusätzliche Zeichen gültig bleiben.

[in] pwzPassword

Gibt das Kennwort an, das zum Aufheben der Verschlüsselung einer Peeridentität verwendet werden soll. Das Kennwort muss mit dem Kennwort für PeerIdentityExport identisch sein. Dieser Parameter darf nicht NULL sein.

[out] ppwzIdentity

Zeiger auf eine Zeichenfolge, die eine importierte Peeridentität darstellt. Wenn der Importvorgang erfolgreich ist, muss die Anwendung ppwzIdentity 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, oder die XML-Daten in ppwzImportXML wurden manipuliert.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_ALREADY_EXISTS	Die Peeridentität ist auf diesem Computer bereits vorhanden.
PEER_E_NO_KEY_ACCESS	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.

Hinweise

Das von PeerIdentityImport verwendete XML-Fragment lautet wie folgt:

<PEERIDENTITYEXPORT VERSION="1.0">
   <IDENTITY>
     <!-- UTF-8 encoded peer name of the identity -->
   </IDENTITY>
   <IDENTITYDATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </IDENTTYDATA>
</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

PeerIdentityExport

Freigeben über