DS_SELECTION 结构 (objsel.h)

DS_SELECTION 结构包含有关用户从对象选取器对话框中选择的对象的数据。 DS_SELECTION_LIST 结构包含DS_SELECTION结构的数组。

语法

typedef struct _DS_SELECTION {
  PWSTR   pwzName;
  PWSTR   pwzADsPath;
  PWSTR   pwzClass;
  PWSTR   pwzUPN;
  VARIANT *pvarFetchedAttributes;
  ULONG   flScopeType;
} DS_SELECTION, *PDS_SELECTION;

成员

pwzName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含对象的相对可分辨名称 (RDN) 。

pwzADsPath

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含对象的 ADsPath。 此字符串的格式取决于从中选择此对象的范围的 DSOP_SCOPE_INIT_INFO 结构的 flScope 成员中指定的标志。

pwzClass

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含对象的 objectClass 属性的值。

pwzUPN

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含对象的 userPrincipalName 属性值。 如果对象没有 userPrincipalName 值， 则 pwzUPN 指向 L“”) (空字符串。

pvarFetchedAttributes

指向 VARIANT 结构数组的指针。 每个 VARIANT 都包含所选对象的属性值。 检索的属性由传递给 IDsObjectPicker：：Initialize 方法的 DSOP_INIT_INFO 结构的 apwzAttributeNames 成员中指定的属性名称确定。 pvarFetchedAttributes 数组中属性的顺序对应于 apwzAttributeNames 数组中指定的属性名称的顺序。

对象选取器对话框可能无法检索请求的属性。 如果无法检索该特性，则 VARIANT 结构的 vt 成员包含VT_EMPTY。

flScopeType

包含一个或多个指示从中选择此对象的作用域类型的 DSOP_SCOPE_TYPE_ 。 有关详细信息以及DSOP_SCOPE_TYPE_标志的列表，请参阅 DSOP_SCOPE_INIT_INFO 结构的 flType 成员。