DSQUERYINITPARAMS structure (dsquery.h)
The DSQUERYINITPARAMS structure describes the data used to initialize a browse dialog box in the directory service query.
Syntax
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.
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
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Header | dsquery.h |