OPENQUERYWINDOW structure (cmnquery.h)

The OPENQUERYWINDOW structure is used with the ICommonQuery::OpenQueryWindow method to initialize the directory service query dialog box.

Syntax

typedef struct {
  DWORD         cbStruct;
  DWORD         dwFlags;
  CLSID         clsidHandler;
  LPVOID        pHandlerParameters;
  CLSID         clsidDefaultForm;
  IPersistQuery *pPersistQuery;
  union {
    void         *pFormParameters;
    IPropertyBag *ppbFormParameters;
  };
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;

Members

cbStruct

Contains the size, in bytes, of the structure. This member is used for versioning and parameter validation and must be filled in before calling ICommonQuery::OpenQueryWindow.

dwFlags

Contains a set of flags that define the behavior of the directory service query dialog box. This can be zero or a combination of one or more of the values listed in the following list.

OQWF_DEFAULTFORM

Causes the query dialog box to select the form specified by the clsidDefaultForm member on initialization.

OQWF_HIDEMENUS

Causes the dialog box to hide the menu bar.

OQWF_HIDESEARCHUI

Causes the query dialog box to be created without the standard search user interface. This includes the Find Now, Stop and Clear All pushbuttons.

OQWF_ISSUEONOPEN

Causes the query to be executed when the query dialog box is first displayed.

OQWF_LOADQUERY

Causes the query dialog box to retrieve the query from the IPersistQuery interface in the pPersistQuery member.

OQWF_OKCANCEL

Causes the query dialog box to display the OK and Cancel buttons, if applicable. The buttons actually displayed in the dialog box will depend on the form used and other specified flags.

OQWF_PARAMISPROPERTYBAG

Indicates that the ppbFormParameters member contains an IPropertyBag interface.

OQWF_REMOVEFORMS

Causes the query dialog box to be created without the form chooser label and drop-down list represented by the Find: label.

OQWF_REMOVESCOPES

Causes the query dialog box to be created without the scope label and drop-down list represented by the In: label.

OQWF_SAVEQUERYONOK

Causes the query dialog box, when closed, to save the query to the IPersistQuery interface in the pPersistQuery member.

OQWF_SHOWOPTIONAL

Causes the query dialog box to display optional forms in the form drop-down list. Optional forms are forms that specify the CQFF_ISOPTIONAL flag in the dwFlags member of the CQFORM structure.

OQWF_SINGLESELECT

Causes the query dialog box to make the query results list single-selection.

clsidHandler

Contains a CLSID value that specifies the query handler to be used by the query dialog box. The value of this member also determines the type of structure pointed to by the pHandlerParameters member.

CLSID_DsQuery

This is the standard directory service query and the only currently supported query.

pHandlerParameters

Pointer to a structure that contains data for the query handler. The type of structure pointed to by this member is defined by the clsidHandler member. The following list lists the possible types of structures based on the value of the clsidHandler member.

CLSID_DsQuery

Contains a pointer to a DSQUERYINITPARAMS structure.

clsidDefaultForm

Specifies the default form to be displayed in the query dialog box. This member is ignored if dwFlags does not contain OQWF_DEFAULTFORM. This member can contain the CLSID of a custom query form or one of the system-supplied forms.

CLSID_DsFindAdvanced

Identifies the Custom Search query form.

CLSID_DsFindComputer

Identifies the Computers query form.

CLSID_DsFindContainer

Identifies the Organizational Units query form.

CLSID_DsFindDomainController

Identifies the Domain Controllers query form.

CLSID_DsFindFrsMembers

Identifies the FRS Members query form.

CLSID_DsFindObjects

Reserved.

CLSID_DsFindPeople

Identifies the Users, Contacts, and Groups query form.

CLSID_DsFindPrinter

Identifies the Printers query form.

CLSID_DsFindVolume

Identifies the Shared Folders query form.

CLSID_DsFindWriteableDomainController

Identifies the Domain Controllers query form and displays writable Domain Controllers.

pPersistQuery

Pointer to an IPersistQuery interface used to store and retrieve query data. This data pertains to the query itself, not the results of the query. If dwFlags contains OQWF_LOADQUERY, the query data is obtained from this interface. If dwFlags contains OQWF_SAVEQUERY, the query data is saved to this interface.

pFormParameters

Reserved. Pointer to a structure or interface that provides parameter initialization data for the form. The contents of this pointer is defined by the form class specified by the clsidDefaultForm member.

ppbFormParameters

Pointer to an IPropertyBag interface that provides parameter initialization data for the form. The contents of this property bag are defined by the form class specified by the clsidDefaultForm member. The following system-supplied forms support this member.

CLSID_DsFindPrinter

This form obtains the following properties from the property bag.

Property name	Description
printName	Contains the initial printer name.
printLocation	Contains the initial printer location.
printModel	Contains the initial model name and/or number of the printer.

 

CLSID_DsFindComputer

Use this form to specify the computer roles. The property bag must include computerRole. Use a combination of the following values to restrict which roles are included:

Value	Role
0x0000	All roles
0x0001	Workstation or Server
0x0002	All Domain Controllers
0x0004	Writable Domain Controllers
0x0008	Read-only Domain Controllers

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	cmnquery.h

See also

CQFORM

DSQUERYINITPARAMS

Display Structures in Active Directory Domain Services

ICommonQuery::OpenQueryWindow

IPersistQuery