Struktur DSBROWSEINFOA (dsclient.h)
Struktur DSBROWSEINFO
Sintaksis
typedef struct {
DWORD cbStruct;
HWND hwndOwner;
LPCSTR pszCaption;
LPCSTR pszTitle;
LPCWSTR pszRoot;
LPWSTR pszPath;
ULONG cchPath;
DWORD dwFlags;
BFFCALLBACK pfnCallback;
LPARAM lParam;
DWORD dwReturnFormat;
LPCWSTR pUserName;
LPCWSTR pPassword;
LPWSTR pszObjectClass;
ULONG cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;
Anggota
cbStruct
Berisi ukuran, dalam byte, dari struktur DSBROWSEINFO
hwndOwner
Handel jendela yang digunakan sebagai induk kotak dialog browser kontainer.
pszCaption
Penunjuk ke string null-terminated yang berisi keterangan kotak dialog. Jika anggota ini null, keterangan default digunakan.
pszTitle
Penunjuk ke string null-terminated yang berisi teks tambahan yang akan ditampilkan dalam kotak dialog di atas kontrol pohon. Jika anggota ini NULL, tidak ada teks tambahan yang ditampilkan.
pszRoot
Penunjuk ke string Unicode null-terminated yang berisi ADsPath kontainer yang ditempatkan di akar kotak dialog. Pengguna tidak dapat menavigasi di atas tingkat ini menggunakan kotak dialog.
pszPath
Penunjuk ke string Unicode null-terminated yang menerima ADsPath dari kontainer yang dipilih dalam dialog. String ini akan selalu dihentikan null meskipun cchPath tidak cukup besar untuk menahan seluruh jalur. Jika dwFlags berisi bendera DSBI_EXPANDONOPEN, anggota ini berisi ADsPath kontainer yang awalnya harus dipilih dalam kotak dialog.
cchPath
Berisi ukuran, dalam karakter WCHAR, dari pszPath buffer.
dwFlags
Berisi sekumpulan bendera yang menentukan perilaku kotak dialog. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.
DSBI_NOBUTTONS (1 (0x1))
Tombol + dan - tidak ditampilkan dalam kotak dialog.
DSBI_NOLINES (2 (0x2))
Garis yang menyambungkan objek dalam kotak dialog tidak ditampilkan.
DSBI_NOLINESATROOT (4 (0x4))
Garis dan tombol di atas objek akar tidak ditampilkan.
DSBI_CHECKBOXES (256 (0x100))
Menyebabkan kotak centang ditempatkan di samping setiap item di pohon. Pengguna dapat menggunakan mouse untuk memilih dan menghapus kotak centang ini. Saat ini memiliki penggunaan terbatas karena tidak ada cara untuk mengatur atau mendapatkan status pemeriksaan item.
DSBI_NOROOT (65536 (0x10000))
Objek akar, yang ditentukan oleh pszRoot, tidak ditampilkan dan objek turunan langsung dari akar ditampilkan di akar pohon. Bendera ini tidak berpengaruh jika pszRoot NULL atau jika anggota ini berisi DSBI_ENTIREDIRECTORY.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Sertakan objek tersembunyi dalam kotak dialog.
DSBI_EXPANDONOPEN (262144 (0x40000))
Saat kotak dialog terbuka, kontainer yang ditentukan dalam pszPath akan terlihat dan dipilih.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Menyertakan semua domain tepercaya ke server yang ditentukan dalam pszRoot atau, secara default, domain tempat pengguna masuk.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Menunjukkan bahwa anggota
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName dan pPassword digunakan untuk kredensial akses. Jika tidak, jika anggota ini tidak berisi DSBI_SIMPLEAUTHENTICATE, dialog menggunakan konteks keamanan utas panggilan.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
Saat menentukan apakah objek ditampilkan dalam kotak dialog, treatAsLeaf penentu tampilan diabaikan.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Menunjukkan bahwa autentikasi aman tidak diperlukan saat memanggil ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Menunjukkan bahwa
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Menunjukkan bahwa penandatanganan dan penyegelan tidak akan digunakan saat berkomunikasi dengan layanan direktori.
pfnCallback
Penunjuk ke fungsi panggilan balik BFFCallBack yang ditentukan aplikasi yang menerima pemberitahuan dari kotak dialog browser kontainer. Atur anggota ini ke NULL jika tidak digunakan.
lParam
Berisi nilai 32-bit yang ditentukan aplikasi yang diteruskan sebagai parameter lpData
dwReturnFormat
Berisi salah satu nilai ADS_FORMAT_ENUM yang menentukan format yang akan diterima jalur ADSI di pszPath.
pUserName
Penunjuk ke string Unicode yang berisi nama pengguna yang digunakan untuk kredensial. Anggota ini diabaikan jika dwFlags tidak memiliki set bendera DSBI_HASCREDENTIALS. Jika anggota ini NULL, nama pengguna yang saat ini masuk digunakan.
pPassword
Penunjuk ke string Unicode yang berisi kata sandi yang digunakan untuk kredensial. Anggota ini diabaikan jika dwFlags tidak memiliki set bendera DSBI_HASCREDENTIALS. Jika anggota ini NULL, kata sandi pengguna yang saat ini masuk digunakan.
pszObjectClass
Penunjuk ke buffer string Unicode yang menerima string kelas dari yang dipilih. Anggota ini diabaikan jika dwFlags tidak memiliki set bendera DSBI_RETURNOBJECTCLASS.
cchObjectClass
Berisi ukuran, dalam karakter WCHAR, dari pszObjectClass buffer.
Komentar
Nota
Header dsclient.h mendefinisikan DSBROWSEINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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
Syarat | Nilai |
---|---|
klien minimum yang didukung | Windows Vista |
server minimum yang didukung |
Windows Server 2008 |
Header |
dsclient.h |