|ITestable3 Interface : LearnChildObjects Method|
Public Function LearnChildObjects( _ ByVal objId As Variant, _ ByVal filterXml As String, _ ByRef learnChildrenXml As String, _ ByRef externalParent As String _ ) As Variant()
- For future use. Currently, always NULL.
- An AddElements xml containing the branch of the object hierarchy starting at the the highest object within the Testing Agent's environment down to the specified object, and the tree from the specified object down to the leaves.
A SAFEARRAY of object IDs.
Returns the list of object IDs from the root to the object, including the object itself, and the object IDs from the specified object down to the leaves. In the learnChildrenXml, set the index attribute of the Element describing each object to the index of the corresponding object in this array. The index of the first array element is zero.
If the Testing Agent does not support the learn functionality, implementation of this method is not required.