ancestorChildNumber Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Returns the number of the nearest ancestor of a node with the requested node name.

Script Syntax

            lValue = oXTLRuntime.ancestorChildNumber(bstrNodeName, pNode);

Remarks

Script Parameters

• bstrNodeName
  String. Node name of the desired ancestor.

• pNode
  Object. Node from which to start the search.

Script Return Value

Long integer. Returns the number of the ancestor relative to its sibling nodes. The first entry in the list is assigned the value 1. Returns Null if there is no such ancestor.

C/C++ Syntax

HRESULT ancestorChildNumber(
  BSTR bstrNodeName,
  IXMLDOMNode *pNode,
  long *pNumber
);

Remarks

C/C++ Parameters

• bstrNodeName
  [in] Node name of the desired ancestor.

• pNode
  [in] Node from which to start the search.

• pNumber
  [out, retval] Number of the ancestor relative to its sibling nodes. The first entry in the list is assigned the value 1. Returns Null if there is no such ancestor.

C/C++ Return Values

Returns S_OK if successful, or an error code otherwise.

Requirements

General Remarks

This method applies to the following interface:

IXTLRuntime.