Struktur DSBROWSEINFOA (dsclient.h)

Artikel
11/20/2024

Struktur DSBROWSEINFO digunakan dengan fungsi DsBrowseForContainer untuk menyediakan dan mengembalikan data tentang kotak dialog browser kontainer Direktori Aktif.

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 . Ini digunakan oleh fungsi DsBrowseForContainer untuk tujuan penerapan versi.

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 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, treatAsLeaf penentu tampilan 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

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 di semua panggilan ke pfnCallback. Anggota ini diabaikan jika pfnCallback NULL.

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

Lihat juga

ADS_FORMAT_ENUM

ADsOpenObject

BFFCallBack

DsBrowseForContainer

Bagikan melalui