ICommonQuery::OpenQueryWindow method (cmnquery.h)

Article
10/13/2021

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