Fungsi PeerGroupDelete (p2p.h)

Artikel
03/04/2024

Fungsi PeerGroupDelete menghapus data lokal dan sertifikat yang terkait dengan grup serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

Parameter

[in] pwzIdentity

Penunjuk ke string Unicode yang berisi identitas yang membuka grup serekan yang ditentukan. Jika parameter ini NULL, implementasinya menggunakan identitas yang diperoleh dari PeerIdentityGetDefault.

[in] pwzGroupPeerName

Penunjuk ke string Unicode yang berisi nama serekan grup serekan tempat data dihapus. Parameter ini diperlukan. Nama grup dapat diperoleh dengan memanggil PeerGroupGetProperties sebelum PeerGroupClose, atau dengan mengurai undangan dengan PeerGroupParseInvitation.

Nilai kembali

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

Catatan Jika operasi penghapusan gagal karena kesalahan sistem file, kesalahan sistem file yang sesuai akan dikembalikan.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Akses ke database grup serekan ditolak. Pastikan bahwa serekan memiliki izin untuk melakukan operasi ini. Dalam hal ini, peer harus menjadi pembuat asli grup serekan.
E_INVALIDARG	Salah satu parameter tidak valid.
PEER_E_NOT_FOUND	Grup serekan tidak dapat ditemukan.
PEER_E_NO_KEY_ACCESS	Akses ke kunci grup identitas atau serekan 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 Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.

Keterangan

Jika grup serekan dihapus, semua handel yang terkait dengan grup tersebut segera menjadi tidak valid. Sebagai praktik terbaik, pastikan bahwa semua handel untuk grup ini ditutup sebelum memanggil fungsi ini. Jika tidak, data ini dihapus dari semua aplikasi serekan lain yang berjalan yang menggunakannya, yang dapat menyebabkan kesalahan dan ketidakstabilan.

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

PeerGroupBuat

Bagikan melalui