Fungsi NetShareDelEx (lmshare.h)

Artikel
03/14/2023

Menghapus nama berbagi dari daftar sumber daya bersama server, yang memutuskan semua koneksi ke berbagi tersebut. Fungsi ini, yang merupakan versi diperluas dari fungsi NetShareDel , memungkinkan pemanggil untuk menentukan struktur SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502, atau SHARE_INFO_503 .

Sintaks

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

Parameter

[in] servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

[in] level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0, 1, 2, atau 502	Menentukan informasi tentang sumber daya bersama, termasuk nama sumber daya, jenis dan izin, dan jumlah koneksi. Parameter buf menunjuk ke struktur SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, atau SHARE_INFO_502 .
503	Menentukan informasi tentang sumber daya bersama, termasuk nama sumber daya, jenis dan izin, jumlah koneksi, dan informasi terkait lainnya. Parameter buf menunjuk ke struktur SHARE_INFO_503 .

[in] buf

Penunjuk ke buffer yang menentukan data. Format data ini tergantung pada nilai parameter tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INTERNAL_ERROR	Terjadi kesalahan internal.
ERROR_INVALID_LEVEL	Nilai yang ditentukan untuk parameter tingkat tidak valid.
ERROR_NOT_SUPPORTED	Permintaan tidak didukung.

Keterangan

Jika 503 ditentukan untuk parameter tingkat , parameter buf menunjuk ke struktur SHARE_INFO_503 , dan anggota shi503_netname dan shi503_servername dari struktur tersebut digunakan untuk mencari sumber daya bersama di server; anggota lain diabaikan. Server jarak jauh yang ditentukan dalam anggota shi503_servername harus terikat ke protokol transportasi menggunakan fungsi NetServerTransportAddEx . Dalam panggilan ke NetServerTransportAddEx, 2 atau 3 harus telah ditentukan untuk parameter tingkat , dan bendera SVTI2_SCOPED_NAME harus telah ditentukan dalam struktur SERVER_TRANSPORT_INFO_2 untuk protokol transportasi.

Jika 0, 1, 2, atau 502 ditentukan untuk parameter tingkat , parameter buf menunjuk ke struktur SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, atau SHARE_INFO_502 , dan shi0_netname,shi1_netname, shi2_netname, atau anggota shi502_netname struktur tersebut digunakan; anggota lain diabaikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmshare.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll