Compartir a través de

Función PeerIdentityImport (p2p.h)

  • Artículo

La función PeerIdentityImport importa una identidad del mismo nivel. Si la identidad del mismo nivel existe en un equipo, se devuelve PEER_E_ALREADY_EXISTS .

Sintaxis

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

Parámetros

[in] pwzImportXML

Puntero a la identidad del mismo nivel de formato XML que se va a importar, que devuelve PeerIdentityExport. Estos datos binarios deben coincidir con el byte de datos exportado. El XML debe permanecer válido sin caracteres adicionales.

[in] pwzPassword

Especifica la contraseña que se va a usar para descifrar una identidad del mismo nivel. La contraseña debe ser idéntica a la contraseña proporcionada a PeerIdentityExport. Este parámetro no puede ser NULL.

[out] ppwzIdentity

Puntero a una cadena que representa una identidad del mismo nivel que se importa. Si la operación de importación se realiza correctamente, la aplicación debe liberar ppwzIdentity 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 o los datos XML de ppwzImportXML se han alterado.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar la operación especificada.
PEER_E_ALREADY_EXISTS
 La identidad del mismo nivel ya existe en este equipo.
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Normalmente, esto se debe 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.

Comentarios

El fragmento XML usado por PeerIdentityImport es el siguiente:

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

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

PeerIdentityExport