Fungsi PeerGroupCreate (p2p.h)

Artikel
03/15/2023

Fungsi PeerGroupCreate membuat grup peer baru.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Parameter

[in] pProperties

Arahkan ke struktur PEER_GROUP_PROPERTIES yang menentukan detail spesifik grup, seperti nama grup serekan, masa pakai undangan, dan masa pakai kehadiran. Parameter ini diperlukan.

Anggota berikut harus diatur:

pwzCreatorPeerName

Anggota berikut ini tidak dapat diatur:

pwzGroupPeerName

Anggota yang tersisa bersifat opsional.

[out] phGroup

Mengembalikan penunjuk gagang ke grup serekan. Fungsi apa pun yang disebut dengan handel ini sebagai parameter memiliki tindakan yang sesuai yang dilakukan pada grup serekan tersebut. Parameter ini diperlukan.

Mengembalikan nilai

Mengembalikan S_OK jika operasi 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_CLOUD_NAME_AMBIGUOUS	Cloud yang ditentukan dalam pProperti tidak dapat ditemukan secara unik (lebih dari satu cloud cocok dengan nama yang disediakan).
PEER_E_INVALID_CLASSIFIER	Pengklasifikasi grup serekan yang ditentukan dalam pProperties tidak valid.
PEER_E_INVALID_PEER_NAME	Nama serekan yang ditentukan untuk grup dalam pProperties tidak valid.
PEER_E_INVALID_PROPERTIES	Satu atau beberapa properti grup serekan yang disediakan dalam pProperties tidak valid.
PEER_E_NO_CLOUD	Cloud yang ditentukan dalam pProperties tidak dapat ditemukan.
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.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	Kata sandi yang ditentukan tidak memenuhi persyaratan kata sandi sistem.
ERROR_DELETE_PENDING	Identitas serekan yang ditentukan sebagai Pembuat Grup telah dihapus atau sedang dalam proses dihapus.

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

Keterangan

PeerGroupConnect harus dipanggil oleh pembuat grup segera setelah pembuatan. Jika ini tidak terjadi, pengguna yang diberi undangan akan berhasil memanggil PeerGroupConnect tetapi mereka tidak akan dapat mendengarkan dan akhirnya akan menerima peristiwa koneksi gagal.

Aplikasi mendapatkan identitas dengan memanggil PeerIdentityCreate, atau metode lain yang mengembalikan string nama identitas. Identitas ini berfungsi sebagai pemilik grup, dan merupakan anggota awal grup serekan saat dibuat.

Untuk aplikasi yang menggunakan kata sandi, disarankan kata sandi ditangani dengan aman dengan memanggil fungsi CryptoProtectMemory dan SecureZeroMemory .

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

Lihat juga

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen

Bagikan melalui