ICommonQuery::OpenQueryWindow method (cmnquery.h)

The ICommonQuery::OpenQueryWindow method displays the directory service query dialog. This method does not return until the dialog box has been closed by the user.

Syntax

HRESULT OpenQueryWindow(
  [in]  HWND              hwndParent,
  [in]  LPOPENQUERYWINDOW pQueryWnd,
  [out] IDataObject       **ppDataObject
);

Parameters

[in] hwndParent

Contains the handle of the window to use as the parent to the query dialog box. This parameter can be NULL if no parent is specified.

[in] pQueryWnd

Address of an OPENQUERYWINDOW structure that defines the query to perform and the characteristics of the query dialog.

[out] ppDataObject

Address of an IDataObject interface pointer that receives the results of the query. This parameter only receives valid data if this method returns S_OK. This IDataObject supports the following clipboard formats.

CFSTR_DSOBJECTNAMES

Contains data about objects selected in the directory service query dialog box.

CFSTR_DSQUERYPARAMS

Contains data about the query performed by the directory service query dialog box.

CFSTR_DSQUERYSCOPE

Contains data about the scope of the query performed by the directory service query dialog box.

Return value

Returns a standard HRESULT value including the following.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	cmnquery.h
Library	Uuid.lib
DLL	Dsquery.dll

See also

CFSTR_DSOBJECTNAMES

CFSTR_DSQUERYPARAMS

CFSTR_DSQUERYSCOPE

DSQUERYINITPARAMS

DSQUERYPARAMS

Display Interfaces in Active Directory Domain Services

ICommonQuery

IDataObject

OPENQUERYWINDOW