Struktur DSQUERYINITPARAMS (dsquery.h)

Artikel
08/23/2023

Struktur DSQUERYINITPARAMS menjelaskan data yang digunakan untuk menginisialisasi kotak dialog telusuri dalam kueri layanan direktori.

Sintaks

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Anggota

cbStruct

Berisi ukuran, dalam byte, dari struktur ini.

dwFlags

Berisi sekumpulan bendera yang menentukan perilaku kueri. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.

DSQPF_ENABLEADMINFEATURES

Menggunakan fitur yang didukung oleh alat administrasi layanan direktori, seperti Admin Penentu Tampilan untuk menu konteks dan halaman properti.

DSQPF_ENABLEADVANCEDFEATURES

Menentukan fitur lanjutan dalam instans IDataObject yang diteruskan ke menu konteks dan halaman properti.

DSQPF_HASCREDENTIALS

Anggota pUserName, pPassword , dan pServer dari struktur ini dapat menentukan data server dan kredensial.

DSQPF_NOCHOOSECOLUMNS

Menonaktifkan item Pilih Kolom dalam menu Tampilan kotak dialog kueri.

DSQPF_NOSAVE

Menghapus item Simpan Pencarian dari menu File kotak dialog kueri.

DSQPF_SAVELOCATION

Anggota pDefaultSaveLocation berisi jalur sistem file default tempat pencarian akan disimpan.

DSQPF_SHOWHIDDENOBJECTS

Menyebabkan kotak dialog kueri menampilkan objek tersembunyi dalam daftar hasil kueri.

pDefaultScope

Penunjuk ke string Unicode yang dihentikan null yang berisi ADsPath dari cakupan default untuk pencarian. Atur anggota ini ke NULL jika tidak ada lingkup pencarian default yang ditentukan.

pDefaultSaveLocation

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur sistem file default tempat pencarian akan disimpan. Anggota ini diabaikan jika anggota dwFlags tidak berisi DSQPF_SAVELOCATION.

pUserName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama pengguna dalam notasi domain yang valid, misalnya, "fabrikam\jeffsmith".

pPassword

Penunjuk ke string Unicode yang dihentikan null yang berisi kata sandi pengguna yang ditentukan oleh anggota pUserName .

pServer

Penunjuk ke string Unicode yang dihentikan null yang berisi nama server tempat daftar domain tepercaya dibaca. Daftar ini digunakan untuk mengisi daftar drop-down Masuk: dalam kotak dialog.

Keterangan

Struktur ini khusus untuk penangan kueri CLSID_DsQuery . Struktur ini digunakan untuk anggota pHandlerParameters dari struktur OPENQUERYWINDOW ketika CLSID_DsQuery diatur untuk anggota clsidHandler dari struktur OPENQUERYWINDOW . Untuk informasi selengkapnya, dan contoh kode untuk menggunakan ini, dan API terkait lainnya, lihat ICommonQuery::OpenQueryWindow.