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.


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


The IQueryForm interface has these methods.


Called to allow a query form extension object to add forms to the query dialog box.

Called to allow a query form object to add pages to an existing form.

Initializes the query form extension object.


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.

      <query handler CLSID>
            <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.
The form should be visible in the normal form list.
The form should be visible in the optional form list.


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