CheckGroupMembershipControl verifies whether a group contains a specific member.
Use CheckGroupMemberShipControl to issue a get call specifying one group and a single member. Virtual member manager searches the underlying repository and returns a boolean value in the control of the return data object to indicate the membership relationship.
The structure of as CheckGroupMembershipControl data object consists of:
CheckGroupMembershipControl level | Description |
---|---|
1 (default) | Returns immediate members only. |
0 | Returns all nested members. |
<xsd:complexType name="CheckGroupMembershipControl">
<xsd:complexContent>
<xsd:extension base="Control">
<xsd:attribute name="level" type="xsd:int" default="1" />
<xsd:attribute name="inGroup" type="xsd:boolean" default="false" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:CheckGroupMembershipControl" level="1"/>
If the member is found in the group the return data object contains the control:
<wim:controls xsi:type="wim:CheckGroupMembershipControl" level="1" inGroup="true"/>
If
the member is not found in the group the value for inGroup is false.