PeerIdentityExport, fonction (p2p.h)

Article
03/04/2024

La fonction PeerIdentityExport permet à un utilisateur d’exporter une identité d’homologue. L’utilisateur peut ensuite transférer l’identité d’homologue vers un autre ordinateur.

Syntaxe

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

Paramètres

[in] pwzIdentity

Spécifie l’identité d’homologue à exporter. Ce paramètre est obligatoire et n’a pas de valeur par défaut.

[in] pwzPassword

Spécifie le mot de passe à utiliser pour chiffrer l’identité de l’homologue. Ce paramètre ne peut pas être NULL. Ce mot de passe doit également être utilisé pour importer l’identité de l’homologue, sinon l’opération d’importation échoue.

[out] ppwzExportXML

Reçoit un pointeur vers l’identité homologue exportée au format XML. Si l’opération d’exportation réussit, l’application doit libérer ppwzExportXML 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.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues a été refusé. Cela est généralement 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.
PEER_E_NOT_FOUND	L’identité d’homologue spécifiée n’existe pas.

Remarques

Les informations d’identification d’appartenance à un groupe d’égal à égal ne sont pas exportées. Une seule identité d’homologue est exportée. Une identité homologue exportée peut être importée sur un autre ordinateur à l’aide de PeerIdentityImport.

L’exportation d’une identité d’homologue ne la supprime pas d’un ccmputer local, mais en fait une copie. La copie peut être utilisée pour sauvegarder et restaurer une identité homologue.

Le fragment XML utilisé par PeerIdentityExport est le suivant :

<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>

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

PeerIdentityImport

Partager via