Fungsi NetShareDel (lmshare.h)

Artikel
03/14/2023

Menghapus nama berbagi dari daftar sumber daya bersama server, memutuskan semua koneksi ke sumber daya bersama.

Fungsi yang diperluas NetShareDelEx memungkinkan pemanggil 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 NetShareDel(
  [in] LMSTR servername,
  [in] LMSTR netname,
       DWORD reserved
);

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] netname

Penunjuk ke string yang menentukan nama berbagi yang akan dihapus.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

reserved

Dicadangkan, harus nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_INVALID_PARAMETER	Parameter yang ditentukan tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.
NERR_NetNameNotFound	Nama berbagi tidak ada.

Keterangan

Fungsi ini hanya berlaku untuk berbagi Blok Pesan Server (SMB). Untuk jenis berbagi lainnya, seperti berbagi Distributed File System (DFS) atau WebDAV, gunakan fungsi Windows Networking (WNet), yang mendukung semua jenis berbagi.

Hanya anggota grup lokal Administrator, Operator Server, atau Pengguna Power, atau yang memiliki keanggotaan grup Operator Server, yang berhasil menghapus berbagi file dengan panggilan ke fungsi NetShareDel . Operator Cetak dapat menghapus berbagi printer.

Jika Anda memprogram Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai fungsionalitas yang sama yang dapat Anda capai dengan memanggil fungsi berbagi manajemen jaringan. Untuk informasi selengkapnya, lihat IADsFileShare.

Contoh

Sampel kode berikut menunjukkan cara menghapus berbagi menggunakan panggilan ke fungsi NetShareDel .

#ifndef UNICODE
#define UNICODE
#endif
#include <windows.h>
#include <stdio.h>
#include <lm.h>
#pragma comment(lib, "Netapi32.lib")

void wmain( int argc, TCHAR *argv[ ])
{
   NET_API_STATUS res;

   if(argc<3)
      printf("Usage: NetShareDel server share\n");
   else
   {
      //
      // Call the NetShareDel function to delete the share.
      //
      res=NetShareDel(argv[1], argv[2], 0);
      //
      // Display the result of the call.
      //
      if(res==0)
         printf("Share Removed.\n");
      else
         printf("Error: %u\n", res);
   }
   return;
}

Persyaratan


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