PeerIdentityGetXML, fonction (p2p.h)

Article
08/25/2023

La fonction PeerIdentityGetXML retourne une description de l’identité d’homologue, qui peut ensuite être transmise à des tiers et utilisée pour inviter une identité d’homologue dans un groupe d’homologues. Ces informations sont retournées sous forme de fragment XML.

Syntaxe

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

Paramètres

[in] pwzIdentity

Spécifie l’identité d’homologue pour laquelle récupérer les informations d’identité d’homologue. Lorsque ce paramètre est passé en tant que NULL, une identité « par défaut » est générée pour l’utilisateur par l’infrastructure homologue.

[out] ppwzIdentityXML

Pointeur vers un pointeur vers une chaîne Unicode qui contient le fragment XML. Lorsque ppwzIdentityXML n’est plus nécessaire, l’application est chargée de libérer cette chaîne en appelant PeerFreeData.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
E_HANDLE	Le handle de l’identité n’est pas valide.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.

Notes

Le fragment XML retourné a la structure suivante :

&lt;PEERIDENTITYINFO VERSION="1.0"&gt;
     &lt;IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64"&gt;
          Base 64 encoded certificate.
     &lt;/IDC&gt;
&lt;/PEERIDENTITYINFO&gt;

Ce fragment XML est utilisé lors de la création d’une invitation à rejoindre un groupe.

Les applications ne sont pas autorisées à ajouter des balises dans la balise PEERIDENTITYINFO ou à modifier ce fragment XML de quelque manière que ce soit. Les applications sont autorisées à incorporer ce fragment XML dans d’autres documents XML, mais doivent supprimer tout le code XML spécifique à l’application avant de passer ce fragment à PeerGroupCreateInvitation.

Spécifications


Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation

Partager via