Fungsi WNetCancelConnection2A (winnetwk.h)

Artikel
08/27/2023

Fungsi WNetCancelConnection2 membatalkan koneksi jaringan yang ada. Anda juga dapat memanggil fungsi untuk menghapus koneksi jaringan yang diingat yang saat ini tidak tersambung.

Fungsi WNetCancelConnection2 menggantikan fungsi WNetCancelConnection .

Sintaks

DWORD WNetCancelConnection2A(
  [in] LPCSTR lpName,
  [in] DWORD  dwFlags,
  [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.

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

[in] dwFlags

Jenis koneksi. Nilai berikut ditentukan.

Nilai	Makna
0	Sistem tidak memperbarui informasi tentang koneksi. Jika koneksi ditandai sebagai persisten di registri, sistem terus memulihkan koneksi pada log masuk berikutnya. Jika koneksi tidak ditandai sebagai persisten, fungsi mengabaikan pengaturan bendera CONNECT_UPDATE_PROFILE.
CONNECT_UPDATE_PROFILE	Sistem memperbarui profil pengguna dengan informasi bahwa koneksi tidak lagi persisten. Sistem tidak akan memulihkan koneksi ini selama operasi masuk berikutnya. (Memutuskan sumber daya menggunakan nama jarak jauh tidak berpengaruh pada koneksi persisten.)

[in] fForce

Menentukan apakah pemutusan harus terjadi 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.

Contoh

Untuk sampel kode yang menggambarkan cara membatalkan koneksi ke sumber daya jaringan dengan panggilan ke fungsi WNetCancelConnection2 , lihat Membatalkan Koneksi Jaringan.

Catatan

Header winnetwk.h mendefinisikan WNetCancelConnection2 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


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