Fungsi PeerGroupExportConfig (p2p.h)

Artikel
03/04/2024

Fungsi PeerGroupExportConfig mengekspor konfigurasi grup untuk peer sebagai string XML yang berisi identitas, nama grup, dan GMC untuk identitas.

Sintaks

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

Parameter

[in] hGroup

Tangani ke grup. Handel ini dikembalikan oleh fungsi PeerGroupCreate, PeerGroupOpen, atau PeerGroupJoin . Parameter ini diperlukan.

[in] pwzPassword

Menentukan kata sandi yang digunakan untuk melindungi konfigurasi yang diekspor. Tidak ada aturan atau batasan untuk pembentukan kata sandi ini. Parameter ini diperlukan.

[out] ppwzXML

Penunjuk ke string konfigurasi XML yang dikembalikan yang berisi identitas, nama serekan grup, nama peer cloud, cakupan grup, dan GMC untuk identitas. Parameter ini diperlukan.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_NO_KEY_ACCESS	Akses ke kunci identitas atau grup ditolak. Biasanya, ini disebabkan oleh daftar kontrol akses (ACL) yang salah untuk folder yang berisi kunci pengguna atau komputer. Ini dapat terjadi ketika ACL diatur ulang secara manual .

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

Keterangan

Setelah diekspor, konfigurasi ini dapat diteruskan di luar band ke rekan lain, di mana konfigurasi identitas dapat dibuat. Untuk mengimpor konfigurasi, berikan string XML yang dikembalikan oleh fungsi ini dengan kata sandi yang diatur ke PeerGroupImportConfig.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2P.lib
DLL	P2P.dll

Bagikan melalui