Struktur CONNECTDLGSTRUCTA (winnetwk.h)

  • Artikel

Struktur CONNECTDLGSTRUCT digunakan oleh fungsi WNetConnectionDialog1 untuk membuat parameter kotak dialog penjelajahan.

Sintaks

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

Anggota

cbStructure

Jenis: DWORD

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

hwndOwner

Jenis: HWND

Gagang ke jendela pemilik untuk kotak dialog.

lpConnRes

Jenis: LPNETRESOURCE

Penunjuk ke struktur NETRESOURCE .

Jika anggota lpRemoteNameNETRESOURCE ditentukan, itu akan dimasukkan ke dalam bidang jalur kotak dialog. Dengan pengecualian anggota dwType , semua anggota struktur NETRESOURCE lainnya harus diatur ke NULL. Anggota dwType harus sama dengan RESOURCETYPE_DISK.

Sistem tidak mendukung bendera RESOURCETYPE_PRINT untuk menjelajah dan menyambungkan ke sumber daya cetak.

dwFlags

Jenis: DWORD

Sekumpulan bendera bit yang menjelaskan opsi untuk tampilan kotak dialog. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai Makna
SidTypeUser
 Akun adalah akun pengguna.
CONNDLG_RO_PATH
 Tampilkan jalur baca-saja alih-alih memperbolehkan pengguna mengetikkan jalur.

Bendera ini harus diatur hanya jika anggota lpRemoteName dari struktur NETRESOURCE yang diacu oleh anggota lpConnRes bukan NULL (atau string kosong), dan bendera CONNDLG_USE_MRU tidak diatur.
CONNDLG_CONN_POINT
 Bendera internal. Jangan gunakan.
CONNDLG_USE_MRU
 Masukkan jalur yang terakhir digunakan ke dalam kotak kombinasi. Atur nilai ini untuk mensimulasikan fungsi WNetConnectionDialog .
CONNDLG_HIDE_BOX
 Perlihatkan kotak centang yang memungkinkan pengguna memulihkan koneksi saat masuk.
CONNDLG_PERSIST
 Pulihkan koneksi saat masuk.
CONNDLG_NOT_PERSIST
 Jangan pulihkan koneksi saat log masuk.
 

Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

dwDevNum

Jenis: DWORD

Jika panggilan ke fungsi WNetConnectionDialog1 berhasil, anggota ini mengembalikan jumlah perangkat yang tersambung. Nilainya adalah 1 untuk A:, 2 untuk B:, 3 untuk C:, dan sebagainya. Jika pengguna membuat koneksi tanpa perangkat, nilainya adalah –1.

Keterangan

Jika bendera CONNDLG_RO_PATH atau CONNDLG_USE_MRU tidak diatur, dan anggota lpRemoteName dari struktur NETRESOURCE tidak menentukan jalur jarak jauh, permintaan default ke jenis tampilan dialog CONNDLG_RO_PATH.

Nilai CONNDLG_PERSIST dan CONNDLG_NOT_PERSIST tidak dapat diatur keduanya. Jika tidak ada yang diatur, kotak dialog default ke opsi terakhir yang dipilih dalam kotak dialog ini untuk tipe koneksi perangkat tertentu.

Catatan

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

SUMBER DAYA NET

WNetConnectionDialog1

Gambaran Umum Windows Networking (WNet)

Struktur Jaringan Windows