DSQUERYINITPARAMS 结构 (dsquery.h)

项目
02/26/2024

DSQUERYINITPARAMS 结构描述用于初始化目录服务查询中的浏览对话框的数据。

语法

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

成员

cbStruct

包含此结构的大小（以字节为单位）。

dwFlags

包含一组用于定义查询行为的标志。这可以是零，也可以是以下一个或多个值的组合。

DSQPF_ENABLEADMINFEATURES

使用目录服务管理工具支持的功能，例如管理员上下文菜单和属性页的显示说明符。

DSQPF_ENABLEADVANCEDFEATURES

指定传递到上下文菜单和属性页的 IDataObject 实例中的高级功能。

DSQPF_HASCREDENTIALS

此结构的 pUserName、 pPassword 和 pServer 成员可以指定服务器和凭据数据。

DSQPF_NOCHOOSECOLUMNS

禁用查询对话框“视图”菜单中的“选择列”项。

DSQPF_NOSAVE

从查询对话框“文件”菜单中删除“保存搜索”项。

DSQPF_SAVELOCATION

pDefaultSaveLocation 成员包含将保存搜索的默认文件系统路径。

DSQPF_SHOWHIDDENOBJECTS

使查询对话框在查询结果列表中显示隐藏的对象。

pDefaultScope

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含搜索的默认范围的 ADsPath。如果未指定默认搜索范围，请将此成员设置为 NULL 。

pDefaultSaveLocation

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含将保存搜索的默认文件系统路径。如果 dwFlags 成员不包含 DSQPF_SAVELOCATION，则忽略此成员。

pUserName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含有效域表示法中的用户名，例如“fabrikam\jeffsmith”。

pPassword

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含 由 pUserName 成员指定的用户的密码。

pServer

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含从中读取受信任域列表的服务器的名称。该列表用于填充对话框中的“ In： ”下拉列表。

注解

此结构特定于 CLSID_DsQuery 查询处理程序。为 OPENQUERYWINDOW 结构的 clsidHandler 成员设置了CLSID_DsQuery时，此结构用于 OPENQUERYWINDOW 结构的 pHandlerParameters 成员。有关详细信息以及使用此 API 和其他相关 API 的代码示例，请参阅 ICommonQuery：：OpenQueryWindow。