Fungsi PeerGroupGetProperties (p2p.h)

Artikel
03/15/2023

Fungsi PeerGroupGetProperties mengambil informasi tentang properti grup tertentu.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

Parameter

[in] hGroup

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

[out] ppProperties

Penunjuk ke struktur PEER_GROUP_PROPERTIES yang berisi informasi tentang properti grup serekan. Data ini harus dibebaskan dengan PeerFreeData. Parameter ini diperlukan.

Nilai kembali

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_GROUP_NOT_READY	Grup tidak dalam status di mana properti grup serekan dapat diambil. Misalnya, PeerGroupJoin dipanggil, tetapi sinkronisasi dengan database grup belum selesai.
PEER_E_INVALID_GROUP	Handel ke grup serekan tidak valid.

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

Keterangan

Properti grup tidak dapat diambil jika serekan belum disinkronkan dengan database grup serekan. Untuk menyinkronkan dengan database grup serekan sebelum memanggil fungsi ini, pertama-tama panggil PeerGroupConnect.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untukWindows 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

PeerGroupJoin

PeergroupBuka

PeerGroupSetProperties

Bagikan melalui