Funzione PeerIdentityGetXML (p2p.h)

Articolo
08/25/2023

La funzione PeerIdentityGetXML restituisce una descrizione dell'identità peer, che può quindi essere passata a terze parti e usata per invitare un'identità peer in un gruppo di peer. Queste informazioni vengono restituite come frammento XML.

Sintassi

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

Parametri

[in] pwzIdentity

Specifica l'identità peer per cui recuperare le informazioni sull'identità peer. Quando questo parametro viene passato come NULL, verrà generata un'identità "predefinita" per l'utente dall'infrastruttura peer.

[out] ppwzIdentityXML

Puntatore a un puntatore a una stringa Unicode contenente il frammento XML. Quando ppwzIdentityXML non è più necessario, l'applicazione è responsabile della liberazione di questa stringa chiamando PeerFreeData.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_HANDLE	L'handle per l'identità non è valido.
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.

Commenti

Il frammento XML restituito ha la struttura seguente:

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

Questo frammento XML viene utilizzato durante la creazione di un invito a partecipare a un gruppo.

Le applicazioni non possono aggiungere tag all'interno del tag PEERIDENTITYINFO o modificare questo frammento XML in alcun modo. Le applicazioni possono incorporare questo frammento XML in altri documenti XML, ma devono rimuovere tutti i dati XML specifici dell'applicazione prima di passare questo frammento a PeerGroupCreateInvitation.

Requisiti


Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack per Windows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation

Condividi tramite