Struktur DSBROWSEINFOA (dsclient.h)

Artikel
08/23/2023

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

Lihat juga