PeerGroupExportConfig, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGroupExportConfig exporte la configuration de groupe d’un homologue sous la forme d’une chaîne XML qui contient l’identité, le nom du groupe et la console GMC de l’identité.

Syntaxe

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

Paramètres

[in] hGroup

Gérez le groupe. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzPassword

Spécifie le mot de passe utilisé pour protéger la configuration exportée. Il n’existe aucune règle ou limite pour la formation de ce mot de passe. Ce paramètre est obligatoire.

[out] ppwzXML

Pointeur vers la chaîne de configuration XML retournée qui contient l’identité, le nom de l’homologue de groupe, le nom de l’homologue cloud, l’étendue du groupe et la console GMC pour l’identité. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
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.
PEER_E_NO_KEY_ACCESS	L’accès aux clés d’identité ou de groupe est refusé. En règle générale, cela est dû à une liste de contrôle d’accès incorrecte pour le dossier qui contient les clés utilisateur ou ordinateur. Cela peut se produire lorsque la liste de contrôle d’accès est réinitialisée manuellement .

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de chiffrement de base Microsoft. Ces erreurs sont précédées de CRYPT_* et définies dans Winerror.h.

Remarques

Une fois exportée, cette configuration peut être transmise hors bande à un autre homologue, où la configuration de l’identité peut être établie. Pour importer la configuration, transmettez la chaîne XML retournée par cette fonction avec le mot de passe défini sur PeerGroupImportConfig.

La chaîne XML de configuration s’affiche au format suivant :

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows 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

Partager via