Struktur OPENQUERYWINDOW (cmnquery.h)
Struktur OPENQUERYWINDOW digunakan dengan metode ICommonQuery::OpenQueryWindow untuk menginisialisasi kotak dialog kueri layanan direktori.
Sintaks
typedef struct {
DWORD cbStruct;
DWORD dwFlags;
CLSID clsidHandler;
LPVOID pHandlerParameters;
CLSID clsidDefaultForm;
IPersistQuery *pPersistQuery;
union {
void *pFormParameters;
IPropertyBag *ppbFormParameters;
};
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;
Anggota
cbStruct
Berisi ukuran, dalam byte, dari struktur. Anggota ini digunakan untuk penerapan versi dan validasi parameter dan harus diisi sebelum memanggil ICommonQuery::OpenQueryWindow.
dwFlags
Berisi sekumpulan bendera yang menentukan perilaku kotak dialog kueri layanan direktori. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai yang tercantum dalam daftar berikut ini.
OQWF_DEFAULTFORM
Menyebabkan kotak dialog kueri memilih formulir yang ditentukan oleh anggota clsidDefaultForm pada inisialisasi .
OQWF_HIDEMENUS
Menyebabkan kotak dialog menyembunyikan bilah menu.
OQWF_HIDESEARCHUI
Menyebabkan kotak dialog kueri dibuat tanpa antarmuka pengguna pencarian standar. Ini termasuk tombol tekan Temukan Sekarang, Hentikan , dan Hapus Semua .
OQWF_ISSUEONOPEN
Menyebabkan kueri dijalankan saat kotak dialog kueri pertama kali ditampilkan.
OQWF_LOADQUERY
Menyebabkan kotak dialog kueri mengambil kueri dari antarmuka IPersistQuery di anggota pPersistQuery .
OQWF_OKCANCEL
Menyebabkan kotak dialog kueri menampilkan tombol OK dan Batal , jika berlaku. Tombol yang benar-benar ditampilkan dalam kotak dialog akan bergantung pada formulir yang digunakan dan bendera tertentu lainnya.
OQWF_PARAMISPROPERTYBAG
Menunjukkan bahwa anggota ppbFormParameters berisi antarmuka IPropertyBag .
OQWF_REMOVEFORMS
Menyebabkan kotak dialog kueri dibuat tanpa label pemilih formulir dan daftar drop-down yang diwakili oleh label Temukan: .
OQWF_REMOVESCOPES
Menyebabkan kotak dialog kueri dibuat tanpa label cakupan dan daftar drop-down yang diwakili oleh label Masuk: .
OQWF_SAVEQUERYONOK
Menyebabkan kotak dialog kueri, saat ditutup, untuk menyimpan kueri ke antarmuka IPersistQuery di anggota pPersistQuery .
OQWF_SHOWOPTIONAL
Menyebabkan kotak dialog kueri menampilkan formulir opsional dalam daftar drop-down formulir. Formulir opsional adalah formulir yang menentukan bendera CQFF_ISOPTIONAL di anggota dwFlags dari struktur CQFORM .
OQWF_SINGLESELECT
Menyebabkan kotak dialog kueri membuat daftar hasil kueri pilihan tunggal.
clsidHandler
Berisi nilai CLSID yang menentukan handler kueri yang akan digunakan oleh kotak dialog kueri. Nilai anggota ini juga menentukan jenis struktur yang diacu oleh anggota pHandlerParameters .
CLSID_DsQuery
Ini adalah kueri layanan direktori standar dan satu-satunya kueri yang saat ini didukung.
pHandlerParameters
Penunjuk ke struktur yang berisi data untuk handler kueri. Jenis struktur yang ditujukan oleh anggota ini ditentukan oleh anggota clsidHandler . Daftar berikut mencantumkan kemungkinan jenis struktur berdasarkan nilai anggota clsidHandler .
CLSID_DsQuery
Berisi penunjuk ke struktur DSQUERYINITPARAMS .
clsidDefaultForm
Menentukan formulir default yang akan ditampilkan dalam kotak dialog kueri. Anggota ini diabaikan jika dwFlags tidak berisi OQWF_DEFAULTFORM. Anggota ini dapat berisi CLSID formulir kueri kustom atau salah satu formulir yang disediakan sistem.
CLSID_DsFindAdvanced
Mengidentifikasi formulir kueri Pencarian Kustom .
CLSID_DsFindComputer
Mengidentifikasi formulir kueri Komputer .
CLSID_DsFindContainer
Mengidentifikasi formulir kueri Unit Organisasi .
CLSID_DsFindDomainController
Mengidentifikasi formulir kueri Pengendali Domain .
CLSID_DsFindFrsMembers
Mengidentifikasi formulir kueri Anggota FRS .
CLSID_DsFindObjects
Dicadangkan.
CLSID_DsFindPeople
Mengidentifikasi formulir kueri Pengguna, Kontak, dan Grup .
CLSID_DsFindPrinter
Mengidentifikasi formulir kueri Printer .
CLSID_DsFindVolume
Mengidentifikasi formulir kueri Folder Bersama .
CLSID_DsFindWriteableDomainController
Mengidentifikasi formulir kueri Pengendali Domain dan menampilkan Pengendali Domain bisa-tulis.
pPersistQuery
Penunjuk ke antarmuka IPersistQuery yang digunakan untuk menyimpan dan mengambil data kueri. Data ini berkaitan dengan kueri itu sendiri, bukan hasil kueri. Jika dwFlags berisi OQWF_LOADQUERY, data kueri diperoleh dari antarmuka ini. Jika dwFlags berisi OQWF_SAVEQUERY, data kueri disimpan ke antarmuka ini.
pFormParameters
Dicadangkan. Penunjuk ke struktur atau antarmuka yang menyediakan data inisialisasi parameter untuk formulir. Isi penunjuk ini ditentukan oleh kelas formulir yang ditentukan oleh anggota clsidDefaultForm .
ppbFormParameters
Penunjuk ke antarmuka IPropertyBag yang menyediakan data inisialisasi parameter untuk formulir. Isi tas properti ini ditentukan oleh kelas formulir yang ditentukan oleh anggota clsidDefaultForm . Formulir yang disediakan sistem berikut mendukung anggota ini.
CLSID_DsFindPrinter
Formulir ini mendapatkan properti berikut dari tas properti.
| Nama properti | Deskripsi |
|---|---|
| printName | Berisi nama pencetak awal. |
| printLocation | Berisi lokasi pencetak awal. |
| printModel | Berisi nama model awal dan/atau nomor printer. |
CLSID_DsFindComputer
Gunakan formulir ini untuk menentukan peran komputer. Tas properti harus menyertakan computerRole. Gunakan kombinasi nilai berikut untuk membatasi peran mana yang disertakan:
| Nilai | Peran |
|---|---|
| 0x0000 | Semua peran |
| 0x0001 | Stasiun kerja atau Server |
| 0x0002 | Semua Pengendali Domain |
| 0x0004 | Pengendali Domain Bisa-Tulis |
| 0x0008 | Pengendali Domain Baca-saja |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Header | cmnquery.h |