Compartir a través de

Función PeerIdentityExport (p2p.h)

  • Artículo

La función PeerIdentityExport permite a un usuario exportar una identidad del mismo nivel. Después, el usuario puede transferir la identidad del mismo nivel a otro equipo.

Sintaxis

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

Parámetros

[in] pwzIdentity

Especifica la identidad del mismo nivel que se va a exportar. Este parámetro es necesario y no tiene un valor predeterminado.

[in] pwzPassword

Especifica la contraseña que se va a usar para cifrar la identidad del mismo nivel. Este parámetro no puede ser NULL. Esta contraseña también se debe usar para importar la identidad del mismo nivel o se produce un error en la operación de importación.

[out] ppwzExportXML

Recibe un puntero a la identidad del mismo nivel exportada en formato XML. Si la operación de exportación se realiza correctamente, la aplicación debe liberar ppwzExportXML llamando a PeerFreeData.

Valor devuelto

Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto Descripción
E_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar la operación especificada.
PEER_E_NO_KEY_ACCESS
 Se denegó el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Esto suele deberse a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se ha restablecido manualmente.
PEER_E_NOT_FOUND
La identidad del mismo nivel especificada no existe.

Comentarios

No se exportan las credenciales de pertenencia a grupos punto a punto. Solo se exporta una identidad del mismo nivel. Se puede importar una identidad del mismo nivel exportada en otro equipo mediante PeerIdentityImport.

La exportación de una identidad del mismo nivel no la quita de un ccmputer local, realiza una copia de ella. La copia se puede usar para realizar copias de seguridad y restaurar una identidad del mismo nivel.

El fragmento XML usado por PeerIdentityExport es el siguiente:

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack para Windows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h
Library P2P.lib
Archivo DLL P2P.dll

Consulte también

PEER_DATA

PeerFreeData

PeerIdentityImport