Fungsi WNetDisconnectDialog (winnetwk.h)

Artikel
03/08/2023

Fungsi WNetDisconnectDialog memulai kotak dialog penjelajahan umum untuk memutuskan sambungan dari sumber daya jaringan. Fungsi ini memerlukan handel ke jendela pemilik untuk kotak dialog.

Sintaks

DWORD WNetDisconnectDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Parameter

[in] hwnd

Tangani ke jendela pemilik untuk kotak dialog.

[in] dwType

Jenis sumber daya yang akan diputuskan sambungannya. Parameter ini dapat memiliki nilai berikut.

Nilai	Makna
RESOURCETYPE_DISK	Memutuskan sambungan dari sumber daya disk.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR. Jika pengguna membatalkan kotak dialog, nilai yang dikembalikan adalah –1.

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

Menampilkan kode	Deskripsi
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError .
ERROR_NO_NETWORK	Jaringan tidak tersedia.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk memulai kotak dialog.

Keterangan

Fungsi WNetDisconnectDialog segera kembali dan membuat kotak dialog untuk memutuskan sambungan drive berjaringan. Kotak dialog ini berjalan secara asinkron pada utas pekerja.

Jika utas pekerja dihentikan, jendela pemilik dan kotak dialog terkait juga dihentikan. Jika ini terjadi, pengguna mungkin tidak dapat berinteraksi dengan kotak dialog, karena tidak akan muncul di layar pengguna atau akan muncul sebentar.

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