Compartir a través de

Función PeerIdentityGetXML (p2p.h)

  • Artículo

La función PeerIdentityGetXML devuelve una descripción de la identidad del mismo nivel, que se puede pasar a terceros y usarse para invitar a una identidad del mismo nivel a un grupo del mismo nivel. Esta información se devuelve como un fragmento XML.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

Parámetros

[in] pwzIdentity

Especifica la identidad del mismo nivel para la que se va a recuperar la información de identidad del mismo nivel. Cuando este parámetro se pasa como NULL, la infraestructura del mismo nivel generará una identidad "predeterminada" para el usuario.

[out] ppwzIdentityXML

Puntero a un puntero a una cadena Unicode que contiene el fragmento XML. Cuando ppwzIdentityXML ya no es necesario, la aplicación es responsable de liberar esta cadena 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_HANDLE
 El identificador de la identidad no es válido.
E_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar la operación especificada.

Comentarios

El fragmento XML devuelto tiene la siguiente estructura:

<PEERIDENTITYINFO VERSION="1.0">
     <IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
          Base 64 encoded certificate.
     </IDC>
</PEERIDENTITYINFO>

Este fragmento XML se usa al crear una invitación para unirse a un grupo.

Las aplicaciones no pueden agregar etiquetas dentro de la etiqueta PEERIDENTITYINFO ni modificar este fragmento XML de ninguna manera. Las aplicaciones pueden incorporar este fragmento XML en otros documentos XML, pero deben quitar todos los XML específicos de la aplicación antes de pasar este fragmento a PeerGroupCreateInvitation.

Requisitos

   
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_CONTACT

PeerFreeData

PeerGroupCreateInvitation