DSOP_INIT_INFO 结构 (objsel.h)
DSOP_INIT_INFO结构包含初始化对象选取器对话框所需的数据。 此结构与 IDsObjectPicker::Initialize 方法一起使用。
语法
typedef struct _DSOP_INIT_INFO {
ULONG cbSize;
PCWSTR pwzTargetComputer;
ULONG cDsScopeInfos;
PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
ULONG flOptions;
ULONG cAttributesToFetch;
PCWSTR *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;
成员
cbSize
包含结构的大小(以字节为单位)。
pwzTargetComputer
指向包含目标计算机名称的以 null 结尾的 Unicode 字符串的指针。 对话框的运行方式与在目标计算机上一样运行,使用目标计算机来确定加入的域和企业。 如果此值为 NULL,则目标计算机为本地计算机。
cDsScopeInfos
指定 aDsScopeInfos 数组中的元素数。
aDsScopeInfos
指向 DSOP_SCOPE_INIT_INFO 结构的数组的指针,这些结构描述用户可以从中选择对象的作用域。 此成员不能为 NULL ,并且数组必须包含至少一个元素,因为对象选取器不能在没有至少一个作用域的情况下运行。
flOptions
确定对象选取器选项的标志。 此成员可以是零,也可以是以下一个或多个标志的组合。
DSOP_FLAG_MULTISELECT (0x00000001)
如果设置了此标志,用户可以选择多个对象。 如果未设置此标志,则用户只能选择一个对象。
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
如果设置了此标志并在 aDsScopeInfos 数组中设置了DSOP_SCOPE_TYPE_TARGET_COMPUTER标志,则目标计算机始终包含在“查找范围”下拉列表中。
如果未设置此标志,并且目标计算机是上级或下级域控制器,则会忽略 DSOP_SCOPE_TYPE_TARGET_COMPUTER 标志,并且目标计算机不包含在“ 查找范围 ”下拉列表中。
若要在初始化过程中节省时间,如果已知目标计算机不是域控制器,则应设置此标志。 但是,如果目标计算机是域控制器,则不应设置此标志,因为用户最好从域范围而不是域控制器本身中选择域对象。
cAttributesToFetch
包含 apwzAttributeNames 数组中的元素数。 此成员可以为零。
apwzAttributeNames
指向以 null 结尾的 Unicode 字符串数组的指针,这些字符串包含要为每个选定对象检索的属性的名称。 如果 cAttributesToFetch 为零,则忽略此成员。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
标头 | objsel.h |