AncestorControl 用于请求实体的祖代。
AncestorControl 数据对象扩展自 HierarchyControl。它在 get API 的输入数据对象中用于请求实体的祖代。如果 AncestorControl 添加到 get 操作中的数据对象,那么返回数据对象中将会返回 Root 数据对象下的实体的祖代。
由于 AncestorControl 扩展自 SearchControl,因此可指定 AncestorControl 中的搜索属性,以便仅返回满足搜索条件的祖代。AncestorControl 还可以用于指定级别和要为祖代返回的属性。
AncestorControl 级别 | 描述 |
---|---|
1(缺省值) | 仅返回父级。 |
任何正整数 | 返回指定级别的祖代。例如,指定 2 将返回两个级别,父级和祖父级。 |
0 | 返回直至 virtual member manager 节点的所有祖代。 |
<xsd:complexType name="AncestorControl">
<xsd:complexContent>
<xsd:extension base="HierarchyControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:AncestorControl" level="0">
<wim:properties>uid</wim:properties>
<wim:properties>cn</wim:properties>
<wim:properties>o</wim:properties>
<wim:properties>ou</wim:properties>
</wim:controls>