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 为零，则忽略此成员。

要求

另请参阅

DSOP_SCOPE_INIT_INFO

目录对象选取器

IDsObjectPicker：：Initialize