Fungsi PeerGroupImportConfig (p2p.h)

Fungsi PeerGroupImportConfig mengimpor konfigurasi grup serekan untuk identitas berdasarkan pengaturan tertentu dalam string konfigurasi XML yang disediakan.

Sintaks

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

Parameter

[in] pwzXML

Menentukan string Unicode yang berisi konfigurasi grup serekan Yang diekspor sebelumnya (menggunakan PeerGroupExportConfig). Untuk format XML tertentu dari string, lihat bagian Keterangan dari topik ini. Parameter ini diperlukan.

[in] pwzPassword

Menentukan kata sandi yang digunakan untuk mengakses data konfigurasi grup serekan terenkripsi, sebagai string Unicode. Parameter ini diperlukan.

[in] fOverwrite

Jika true, konfigurasi grup yang ada akan ditimpa. Jika false, konfigurasi grup ditulis hanya jika konfigurasi grup sebelumnya tidak ada. Nilai defaultnya adalah false. Parameter ini diperlukan.

[out] ppwzIdentity

Berisi identitas serekan yang dikembalikan setelah impor selesai. Parameter ini diperlukan.

[out] ppwzGroup

Berisi nama serekan grup serekan yang dikembalikan setelah impor selesai. Parameter ini diperlukan.

Mengembalikan nilai

Mengembalikan S_OK jika fungsi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.

Kesalahan khusus kriptografi dapat dikembalikan dari Penyedia Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.

Keterangan

Untuk menghasilkan konfigurasi grup serekan, panggil PeerGroupExportConfig, teruskan identitas untuk mengekspor, kata sandi, dan handel ke grup serekan.

String XML konfigurasi muncul dalam format berikut:

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

Persyaratan