PeerIdentityImport, fonction (p2p.h)

Article
03/01/2024

La fonction PeerIdentityImport importe une identité homologue. Si l’identité homologue existe sur un ordinateur, PEER_E_ALREADY_EXISTS est retourné.

Syntaxe

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

Paramètres

[in] pwzImportXML

Pointeur vers l’identité d’homologue au format XML à importer, qui est retournée par PeerIdentityExport. Ces données binaires doivent correspondre à l’octet de données exporté par octet. Le code XML doit rester valide sans caractères supplémentaires.

[in] pwzPassword

Spécifie le mot de passe à utiliser pour déchiffrer une identité homologue. Le mot de passe doit être identique au mot de passe fourni à PeerIdentityExport. Ce paramètre ne peut pas être NULL.

[out] ppwzIdentity

Pointeur vers une chaîne qui représente une identité homologue importée. Si l’opération d’importation réussit, l’application doit libérer ppwzIdentity en appelant PeerFreeData.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide ou les données XML dans ppwzImportXML ont été falsifiées.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_ALREADY_EXISTS	L’identité d’homologue existe déjà sur cet ordinateur.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.

Remarques

Le fragment XML utilisé par PeerIdentityImport est le suivant :

&lt;PEERIDENTITYEXPORT VERSION="1.0"&gt;
   &lt;IDENTITY&gt;
     &lt;!-- UTF-8 encoded peer name of the identity --&gt;
   &lt;/IDENTITY&gt;
   &lt;IDENTITYDATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64"&gt;
      &lt;!-- base64 encoded / PFX encoded and encrypted IDC with the private key --&gt;
   &lt;/IDENTTYDATA&gt;
&lt;/PEERIDENTITYEXPORT&gt;

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PEER_DATA

PeerFreeData

PeerIdentityExport

Partager via