Fungsi NetUseDel (lmuse.h)

Artikel
08/24/2023

Fungsi NetUseDel mengakhiri koneksi ke sumber daya bersama.

Anda juga dapat menggunakan fungsi WNetCancelConnection2 untuk mengakhiri koneksi jaringan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Parameter

[in] UncServerName

Nama UNC komputer untuk menjalankan fungsi ini. Jika ini adalah parameter NULL, maka komputer lokal digunakan.

Jika parameter UncServerName yang ditentukan adalah komputer jarak jauh, komputer jarak jauh harus mendukung panggilan RPC jarak jauh menggunakan mekanisme Protokol Akses Jarak Jauh warisan.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

[in] UseName

Penunjuk ke string yang menentukan jalur koneksi yang akan dihapus.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

[in] ForceLevelFlags

Tingkat paksa untuk digunakan dalam menghapus koneksi.

Parameter ini dapat menjadi salah satu nilai berikut yang ditentukan dalam file header lmuseflg.h .

Nilai	Makna
USE_NOFORCE	Gagalkan pemutusan sambungan jika ada file yang terbuka pada sambungan.
USE_FORCE	Jangan gagalkan pemutusan jika ada berkas terbuka pada sambungan.
USE_LOTS_OF_FORCE	Tutup file yang terbuka dan hapus koneksi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Fungsi NetUseDel hanya berlaku untuk klien Blok Pesan Server (Stasiun Kerja Manajer LAN). Fungsi NetUseDel tidak mendukung berbagi Sistem File Terdistribusi (DFS) atau sistem file jaringan lainnya. Untuk mengakhiri koneksi ke berbagi menggunakan penyedia jaringan yang berbeda (WebDAV atau berbagi DFS, misalnya), gunakan fungsi WNetCancelConnection2 .

Tidak ada keanggotaan grup khusus yang diperlukan untuk memanggil fungsi NetUseDel . Fungsi ini tidak dapat dijalankan pada server jarak jauh kecuali dalam kasus kompatibilitas tingkat bawah.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmuse.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll