PeerGroupImportConfig, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupImportConfig importe une configuration de groupe d’homologues pour une identité en fonction des paramètres spécifiques d’une chaîne de configuration XML fournie.

Syntaxe

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

Paramètres

[in] pwzXML

Spécifie une chaîne Unicode qui contient une configuration de groupe d’homologues précédemment exportée (à l’aide de PeerGroupExportConfig). Pour connaître le format XML spécifique de la chaîne, consultez la section Remarques de cette rubrique. Ce paramètre est obligatoire.

[in] pwzPassword

Spécifie le mot de passe utilisé pour accéder aux données de configuration du groupe d’homologues chiffrés, sous la forme d’une chaîne Unicode. Ce paramètre est obligatoire.

[in] fOverwrite

Si la valeur est true, la configuration de groupe existante est remplacée. Si la valeur est false, la configuration du groupe est écrite uniquement si une configuration de groupe précédente n’existe pas. La valeur par défaut est false. Ce paramètre est obligatoire.

[out] ppwzIdentity

Contient l’identité d’homologue retournée une fois l’importation terminée. Ce paramètre est obligatoire.

[out] ppwzGroup

Contient un nom d’homologue de groupe d’homologues retourné une fois l’importation terminée. 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 une opération spécifiée.
PEER_E_ALREADY_EXISTS	Une configuration de groupe d’homologues existe déjà, et fOverwrite a la valeur false.

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

Remarques

Pour générer une configuration de groupe d’homologues, appelez PeerGroupExportConfig, transmettez une identité à exporter, un mot de passe et un handle au groupe d’homologues.

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

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