Funzione PeerGroupImportConfig (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupImportConfig importa una configurazione del gruppo peer per un'identità in base alle impostazioni specifiche in una stringa di configurazione XML fornita.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupImportConfig(
  [in]  PCWSTR pwzXML,
  [in]  PCWSTR pwzPassword,
  [in]  BOOL   fOverwrite,
  [out] PWSTR  *ppwzIdentity,
  [out] PWSTR  *ppwzGroup
);

Parametri

[in] pwzXML

Specifica una stringa Unicode che contiene una configurazione del gruppo peer esportata in precedenza (tramite PeerGroupExportConfig). Per il formato XML specifico della stringa, vedere la sezione Osservazioni di questo argomento. Questo parametro è obbligatorio.

[in] pwzPassword

Specifica la password utilizzata per accedere ai dati di configurazione del gruppo peer crittografato, come stringa Unicode. Questo parametro è obbligatorio.

[in] fOverwrite

Se true, la configurazione del gruppo esistente viene sovrascritta. Se false, la configurazione del gruppo viene scritta solo se non esiste una configurazione di gruppo precedente. Il valore predefinito è false. Questo parametro è obbligatorio.

[out] ppwzIdentity

Contiene l'identità peer restituita al termine di un'importazione. Questo parametro è obbligatorio.

[out] ppwzGroup

Contiene un nome peer del gruppo peer restituito dopo il completamento di un'importazione. 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 un'operazione specificata.
PEER_E_ALREADY_EXISTS	Esiste già una configurazione del gruppo di peer e fOverwrite è impostata su false.

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

Commenti

Per generare una configurazione del gruppo peer, chiamare PeerGroupExportConfig, passare un'identità da esportare, una password e un handle al gruppo peer.

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 peer 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 that contains 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