Função PeerIdentityGetXML (p2p.h)
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 |
|---|---|
|
O identificador para a identidade é inválido. |
|
Um dos parâmetros não é válido. |
|
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 |