Fungsi PeerGroupSetProperties (p2p.h)

Artikel
03/13/2024

Fungsi PeerGroupSetProperties mengatur properti grup serekan saat ini. Dalam API versi 1.0 ini, hanya pembuat grup serekan yang dapat melakukan operasi ini.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Parameter

[in] hGroup

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

[in] pProperties

Arahkan ke struktur PEER_GROUP_PROPERTIES yang diisi serekan yang berisi properti baru. Untuk mendapatkan struktur ini, serekan harus terlebih dahulu memanggil PeerGroupGetProperties, mengubah bidang yang sesuai, lalu meneruskannya sebagai parameter ini. Parameter ini diperlukan.

Anggota PEER_GROUP_PROPERTIES berikut tidak dapat diubah:

dwSize
pwzCloud
pwzClassifier
pwzGroupPeerName
pwzCreatorPeerName

Nilai kembali

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

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi.
PEER_E_GROUP_NOT_READY	Grup tidak dalam status di mana properti grup serekan dapat diatur. Misalnya, PeerGroupJoin telah dipanggil, tetapi sinkronisasi dengan database grup serekan tidak selesai.
PEER_E_INVALID_GROUP	Handel ke grup serekan tidak valid.
PEER_E_INVALID_GROUP_PROPERTIES	Satu atau beberapa properti yang ditentukan tidak valid.
PEER_E_NOT_AUTHORIZED	Identitas saat ini tidak memiliki otorisasi untuk mengubah properti ini. Dalam hal ini, identitas bukan pembuat grup serekan.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	Kata sandi yang ditentukan tidak memenuhi persyaratan kata sandi sistem.

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

Keterangan

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

PeerGroupBuat

PeerGroupGetProperties

PeerGroupJoin

PeerGroupOpen

Bagikan melalui