DSQUERYINITPARAMS

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

typedef struct
{
  DWORD cbStruct;           
  DWORD dwFlags;            
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Members

cbStruct

Size of this structure, used for versioning and validation.

dwFlags

flags that defines the behavior of the resulting query window. It can a combination of the following:

dwFlags	Description
DSQPF_ENABLEADMINFEATURES	Uses features already 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 that is passed to context menus and property pages.
DSQPF_HASCREDENTIALS	The pUserName, pPassword and pServer members of this structure may specify server and credential information.
DSQPF_NOSAVE	Removes the File/Save menu item.
DSQPF_SAVELOCATION	pDefaultSaveLocation is a valid system path.

pDefaultScope

LDAP URL, in ADSI format, used to specify the default scope for the search.

pDefaultSaveLocation

Default path appeared in File/Save dialog.

pUserName

User name in the valid domain notation, such as ntdev\jsmith.

pPassword

Password of the user.

pServer

Name of the server from which the list of trusted domains is read. The list is used to populate the "In:" list on the dialog.

Remarks

This structure is specific to the DsQuery handler. It is used when CLSID_DsQuery is set for the clsidHandler member of the OPENQUERYWINDOW structure. For a code example on how to use this and other related API, see ICommonQuery::OpenQueryWindow.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsquery.h.

See Also

Active Directory Display Structures, OPENQUERYWINDOW, ICommonQuery::OpenQueryWindow