DSQUERYINITPARAMS

The DSQUERYINITPARAMS structure describes the data used to initialize a browse dialog box in the directory service query.

typedef struct {

  DWORD cbStruct;

  DWORD dwFlags;

  LPWSTR pDefaultScope;

  LPWSTR pDefaultSaveLocation;

  LPWSTR pUserName;

  LPWSTR pPassword;

  LPWSTR pServer;
} DSQUERYINITPARAMS, 

*LPDSQUERYINITPARAMS;

Members

cbStruct

Contains the size, in bytes, of this structure.

dwFlags

Contains a set of flags that define the query behavior. This can be zero or a combination of one or more of the following values.

Value	Meaning
DSQPF_ENABLEADMINFEATURES	Uses features supported by the directory service administration tools, such as Admin Display Specifier for context menus and property pages.
DSQPF_ENABLEADVANCEDFEATURES	Specifies advanced features in the IDataObject instance passed to context menus and property pages.
DSQPF_HASCREDENTIALS	The pUserName, pPassword and pServer members of this structure can specify server and credential data.
DSQPF_NOCHOOSECOLUMNS	Disables the Choose Columns item in the query dialog box View menu.
DSQPF_NOSAVE	Removes the Save Search item from the query dialog box File menu.
DSQPF_SAVELOCATION	The pDefaultSaveLocation member contains the default file system path where searches will be saved.
DSQPF_SHOWHIDDENOBJECTS	Causes the query dialog box to display hidden objects in the query results list.

pDefaultScope

Pointer to a null-terminated Unicode string that contains the ADsPath of the default scope for the search. Set this member to NULL if no default search scope is specified.

pDefaultSaveLocation

Pointer to a null-terminated Unicode string that contains the default file system path where searches will be saved. This member is ignored if the dwFlags member does not contain DSQPF_SAVELOCATION.

pUserName

Pointer to a null-terminated Unicode string that contains the user name in the valid domain notation, for example, "fabrikam\jeffsmith".

pPassword

Pointer to a null-terminated Unicode string that contains the password of the user specified by the pUserName member.

pServer

Pointer to a null-terminated Unicode string that contains the name of the server from which the list of trusted domains is read. The list is used to populate the In: drop-down list in the dialog box.

Remarks

This structure is specific to the CLSID_DsQuery query handler. This structure is used for the pHandlerParameters member of the OPENQUERYWINDOW structure when CLSID_DsQuery is set for the clsidHandler member of the OPENQUERYWINDOW structure. For more information, and a code example for using this, and other related APIs, see ICommonQuery::OpenQueryWindow.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsquery.h.

See Also

IDataObject, OPENQUERYWINDOW, ICommonQuery::OpenQueryWindow, Active Directory Display Structures