Fungsi WNetCancelConnectionA (winnetwk.h)

Artikel
08/27/2023

Fungsi WNetCancelConnection membatalkan koneksi jaringan yang ada.

Fungsi WNetCancelConnection disediakan untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi berbasis Windows lainnya harus memanggil fungsi WNetCancelConnection2 .

Sintaks

DWORD WNetCancelConnectionA(
  [in] LPCSTR lpName,
  [in] BOOL   fForce
);

Parameter

[in] lpName

Penunjuk ke string konstanta yang dihentikan null yang menentukan nama perangkat lokal yang dialihkan atau sumber daya jaringan jarak jauh untuk memutuskan sambungan.

Ketika parameter ini menentukan perangkat lokal yang dialihkan, fungsi hanya membatalkan pengalihan perangkat yang ditentukan. Jika parameter menentukan sumber daya jaringan jarak jauh, hanya koneksi ke jaringan jarak jauh tanpa perangkat yang dibatalkan.

[in] fForce

Menentukan apakah pemutusan sambungan harus terjadi atau tidak jika ada file atau pekerjaan yang terbuka pada koneksi. Jika parameter ini FALSE, fungsi gagal jika ada file atau pekerjaan yang terbuka.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_BAD_PROFILE	Profil pengguna dalam format yang salah.
ERROR_CANNOT_OPEN_PROFILE	Sistem tidak dapat membuka profil pengguna untuk memproses koneksi persisten.
ERROR_DEVICE_IN_USE	Perangkat sedang digunakan oleh proses aktif dan tidak dapat terputus.
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError .
ERROR_NOT_CONNECTED	Nama yang ditentukan oleh parameter lpName bukan perangkat yang dialihkan, atau sistem saat ini tidak terhubung ke perangkat yang ditentukan oleh parameter .
ERROR_OPEN_FILES	Ada file terbuka, dan parameter fForceadalah FALSE.

Keterangan

Windows Server 2003 dan Windows XP: Fungsi WNet membuat dan menghapus huruf drive jaringan di namespace perangkat MS-DOS yang terkait dengan sesi masuk karena perangkat MS-DOS diidentifikasi oleh AuthenticationID. (AuthenticationID adalah pengidentifikasi unik lokal, atau LUID, yang terkait dengan sesi masuk.) Ini dapat memengaruhi aplikasi yang memanggil salah satu fungsi WNet untuk membuat huruf kandar jaringan di bawah satu masuk pengguna, tetapi kueri untuk huruf drive jaringan yang ada di bawah masuk pengguna yang berbeda. Contoh situasi ini bisa jadi ketika log masuk kedua pengguna dibuat dalam sesi masuk, misalnya, dengan memanggil fungsi CreateProcessAsUser , dan masuk kedua menjalankan aplikasi yang memanggil fungsi GetLogicalDrives . GetLogicalDrives tidak mengembalikan huruf kandar jaringan yang dibuat oleh fungsi WNet di bawah log masuk pertama. Perhatikan bahwa dalam contoh sebelumnya sesi masuk pertama masih ada, dan contohnya dapat berlaku untuk sesi masuk apa pun, termasuk sesi Layanan Terminal. Untuk informasi selengkapnya, lihat Menentukan Nama Perangkat MS-DOS.

Catatan

Header winnetwk.h mendefinisikan WNetCancelConnection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll