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

   
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