Funzione PeerGroupExportConfig (p2p.h)

Articolo
08/25/2023

La funzione PeerGroupExportConfig esporta la configurazione del gruppo per un peer come stringa XML contenente l'identità, il nome del gruppo e il GMC per l'identità.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupExportConfig(
  [in]  HGROUP hGroup,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzXML
);

Parametri

[in] hGroup

Gestire il gruppo. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pwzPassword

Specifica la password usata per proteggere la configurazione esportata. Non esistono regole o limiti per la formazione di questa password. Questo parametro è obbligatorio.

[out] ppwzXML

Puntatore alla stringa di configurazione XML restituita contenente l'identità, il nome peer del gruppo, il nome del peer cloud, l'ambito del gruppo e il GMC per l'identità. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi di identità o gruppo viene negato. In genere, questo è causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL viene reimpostato manualmente.

Gli errori specifici della crittografia possono essere restituiti dal provider di crittografia di base Microsoft. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Dopo l'esportazione, questa configurazione può essere passata fuori banda a un altro peer, in cui è possibile stabilire la configurazione dell'identità. Per importare la configurazione, passare la stringa XML restituita da questa funzione con la password impostata su PeerGroupImportConfig.

La stringa XML di configurazione viene visualizzata nel formato seguente:

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the group -->
  </GROUPPEERNAME>
  <CLOUDNAME>
    <!-- UTF-8 encoded Unicode name of the cloud -->
  </CLOUDNAME>
  <SCOPE>
    <!-- UTF-8 encoded Unicode name of the scope: global, site-local, link-local -->
  </SCOPE>
  <CLOUDFLAGS>
    <!-- A DWORD containing cloud-specific settings, represented as a string -->
  </CLOUDFLAGS>
  <GMC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
    <!-- base64/PKCS7 encoded GMC chain -->
  </GMC>
</PEERGROUPCONFIG>

Requisiti

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

Condividi tramite