Compartilhar via

Função PeerIdentityGetXML (p2p.h)

  • Artigo

A função PeerIdentityGetXML retorna uma descrição da identidade de par, que pode ser passada para terceiros e usada para convidar uma identidade de par para um grupo de pares. Essas informações são retornadas como um fragmento XML.

Sintaxe

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

Parâmetros

[in] pwzIdentity

Especifica a identidade de par para a qual recuperar informações de identidade de par. Quando esse parâmetro for passado como NULL, uma identidade "padrão" será gerada para o usuário pela infraestrutura par.

[out] ppwzIdentityXML

Ponteiro para um ponteiro para uma cadeia de caracteres Unicode que contém o fragmento XML. Quando ppwzIdentityXML não é mais necessário, o aplicativo é responsável por liberar essa cadeia de caracteres chamando PeerFreeData.

Valor retornado

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_HANDLE
 O identificador para a identidade é inválido.
E_INVALIDARG
 Um dos parâmetros não é válido.
E_OUTOFMEMORY
 Não há memória suficiente para executar a operação especificada.

Comentários

O fragmento XML retornado tem a seguinte estrutura:

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

Esse fragmento XML é usado ao criar um convite para ingressar em um grupo.

Os aplicativos não têm permissão para adicionar marcas na marca PEERIDENTITYINFO ou modificar esse fragmento XML de forma alguma. Os aplicativos têm permissão para incorporar esse fragmento XML em outros documentos XML, mas devem remover todos os XML específicos do aplicativo antes de passar esse fragmento para o PeerGroupCreateInvitation.

Requisitos

   
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado para Windows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2P.lib
DLL P2P.dll

Confira também

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation