Struktur DISCDLGSTRUCTA (winnetwk.h)

  • Artikel

Struktur DISCDLGSTRUCT digunakan dalam fungsi WNetDisconnectDialog1 . Struktur berisi informasi yang diperlukan untuk upaya pemutusan sambungan.

Sintaks

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Anggota

cbStructure

Jenis: DWORD

Ukuran, dalam byte, dari struktur DISCDLGSTRUCT . Pemanggil harus menyediakan nilai ini.

hwndOwner

Jenis: HWND

Handel ke jendela pemilik kotak dialog.

lpLocalName

Jenis: LPTSTR

Penunjuk ke string yang dihentikan NULL yang menentukan nama perangkat lokal yang dialihkan ke sumber daya jaringan, seperti "F:" atau "LPT1".

lpRemoteName

Jenis: LPTSTR

Penunjuk ke string yang dihentikan NULL yang menentukan nama sumber daya jaringan yang akan diputus. Anggota ini bisa NULL jika anggota lpLocalName ditentukan. Ketika lpLocalName ditentukan, koneksi ke sumber daya jaringan yang dialihkan dari lpLocalName terputus.

dwFlags

Jenis: DWORD

Sekumpulan bendera bit yang menjelaskan koneksi. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai Makna
DISC_UPDATE_PROFILE
 Jika nilai ini diatur, koneksi yang ditentukan tidak lagi persisten (dipulihkan secara otomatis setiap kali pengguna masuk). Bendera ini hanya valid jika anggota lpLocalName menentukan perangkat lokal.
DISC_NO_FORCE
 Jika nilai ini tidak diatur, sistem menerapkan paksa saat mencoba memutuskan sambungan dari sumber daya jaringan.

Situasi ini biasanya terjadi ketika pengguna memiliki file yang terbuka melalui koneksi. Nilai ini berarti bahwa pengguna akan diberi tahu jika ada file terbuka pada koneksi, dan ditanya apakah dia masih ingin memutuskan sambungan. Jika pengguna ingin melanjutkan, prosedur pemutusan sambungan akan mencoba kembali dengan kekuatan tambahan.

Keterangan

Catatan

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

Lihat juga

WNetDisconnectDialog1

Gambaran Umum Windows Networking (WNet)

Struktur Jaringan Windows