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

Lihat juga

CQFORM

DSQUERYINITPARAMS

Tampilkan Struktur dalam Active Directory Domain Services

ICommonQuery::OpenQueryWindow

IPersistQuery