IQueryForm interface (cmnquery.h)

The IQueryForm interface is implemented by a query form extension object to allow the form object to add forms and pages to the system-supplied directory service query dialog box.

Inheritance

The IQueryForm interface inherits from the IUnknown interface. IQueryForm also has these types of members:

Methods

The IQueryForm interface has these methods.

IQueryForm::AddForms Called to allow a query form extension object to add forms to the query dialog box.
IQueryForm::AddPages Called to allow a query form object to add pages to an existing form.
IQueryForm::Initialize Initializes the query form extension object.

Remarks

A query form extension object must be registered in the Windows registry to be available to the query handler. This is accomplished by adding the following registry key.

HKEY_CLASSES_ROOT
   CLSID
      <query handler CLSID>
         Forms
            <name of query form extension>

The <query handler CLSID> key is the class identifier of the form handler. The <name of query form extension> key is the unique name of the query form extension. This name must be unique within the Forms key. It is suggested that the string form of the class identifier of the query form extension be used for the name.

The following list lists the registry entries under the above key.

Registry Entry	Description
CLSID	A string value that contains the class identifier of the object that implements IQueryForm.
Flags	A numeric value that contains a set of flags that define the behavior of the form. This can be zero or a combination of one or more of the following values. QUERYFORM_CHANGESFORMLIST The form should be visible in the normal form list. QUERYFORM_CHANGESOPTFORMLIST The form should be visible in the optional form list.

Requirements

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

See also

Display Interfaces in Active Directory Domain Services