PeerIdentityImport-Funktion (p2p.h)

  • Artikel

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