Directory Services

DSQUERYPARAMS

The DSQUERYPARAMS structure contains query data used by the directory service query when searching the directory service. This structure is provided by the CFSTR_DSQUERYPARAMS clipboard format by the IDataObject provided by the ICommonQuery::OpenQueryWindow method. The caller of ICommonQuery::OpenQueryWindow can use this to retrieve the filter, column data used by the result view when issuing a query against the server.

typedef struct {
DWORD cbStruct;
DWORD dwFlags;
HINSTANCE hInstance;
LONG offsetQuery;
LONG iColumns;
DWORD dwReserved;
DSCOLUMN aColumns[1]; } DSQUERYPARAMS,
*LPDSQUERYPARAMS;

Members

cbStruct
Contains the size, in bytes, of the DSQUERYPARAMS structure. This member is used for versioning of the structure.
dwFlags
Not currently used.
hInstance
Contains an instance handle used for extracting resources.
offsetQuery
Contains the offset, in bytes, from the address of this structure to a null-terminated Unicode string that contains the LDAP filter.
iColumns
Contains the number of elements in the aColumns array.
dwReserved
Reserved for future use.
aColumns
Contains an array of DSCOLUMN structures that contain the results of the query. The iColumns member specifies the number of elements in this array.

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

CFSTR_DSQUERYPARAMS, ICommonQuery::OpenQueryWindow, DSCOLUMN, Active Directory Display Structures