Struktur DSBROWSEINFOA (dsclient.h)
Struktur DSBROWSEINFO digunakan dengan fungsi DsBrowseForContainer untuk menyediakan dan mengembalikan data tentang kotak dialog browser kontainer Direktori Aktif.
Sintaks
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 . Ini digunakan oleh fungsi DsBrowseForContainer untuk tujuan penerapan versi.
hwndOwner
Gagang jendela yang digunakan sebagai induk kotak dialog browser kontainer.
pszCaption
Penunjuk ke string yang dihentikan null yang berisi caption kotak dialog. Jika anggota ini NULL, caption default akan digunakan.
pszTitle
Penunjuk ke string yang dihentikan null 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 yang dihentikan null yang berisi ADsPath dari kontainer yang ditempatkan di akar kotak dialog. Pengguna tidak dapat menavigasi di atas tingkat ini menggunakan kotak dialog.
pszPath
Penunjuk ke string Unicode yang dihentikan null 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 dari kontainer yang awalnya harus dipilih dalam kotak dialog.
cchPath
Berisi ukuran, dalam karakter WCHAR , dari buffer pszPath .
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 mengosongkan 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 pszRootadalah 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 dwReturnFormat valid. Jika bendera ini tidak diatur, format jalur default ke X.500.
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, penentu tampilan treatAsLeaf diabaikan.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Menunjukkan bahwa autentikasi aman tidak diperlukan saat memanggil ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Menunjukkan bahwa pszObjectClass dan cchObjectClass valid dan harus diisi.
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Menunjukkan bahwa penandatanganan dan penyegelan tidak akan digunakan saat berkomunikasi dengan layanan direktori.
pfnCallback
Arahkan 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 di semua panggilan ke pfnCallback. Anggota ini diabaikan jika pfnCallbackNULL.
dwReturnFormat
Berisi salah satu nilai ADS_FORMAT_ENUM yang menentukan format yang akan diterima jalur ADSI dalam 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 akan 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 akan digunakan.
pszObjectClass
Penunjuk ke buffer string Unicode yang menerima string kelas yang dipilih. Anggota ini diabaikan jika dwFlags tidak memiliki set bendera DSBI_RETURNOBJECTCLASS .
cchObjectClass
Berisi ukuran, dalam karakter WCHAR , dari buffer pszObjectClass .
Keterangan
Catatan
Header dsclient.h mendefinisikan DSBROWSEINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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 Vista |
Server minimum yang didukung | Windows Server 2008 |
Header | dsclient.h |