FindNodes Method

FindNodes Method (McDBNode)

Description

Search for McDBNode instances in the object hierarchy of this McDBNode.

Return Type

A McDBNodes object.

McDBNodes

Syntax

object.FindNodes (Query, [mode])

The FindNodes Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDBNode.
Query	Required. A McDBQuery object. The McDBQuery specifying the McDBNodes to match and return.
mode	Optional. A mcDBQueryMode enumeration, as described in settings. Whether the query should recurse the McDBNode.Children of this and descendant child McDBNode instances.

Settings

The settings for mode are:

Constant		Value	Description
	mcdbShallow	0	The McDBNode and its immediate Children
	mcdbRecursive	1	The McDBNode and all of its descendants
	mcdbNoForeign	2	Do not include foreign references [bit flag]
	mcdbShallowNoForeign	2	The McDBNode and all of its non-foreign children
	mcdbRecursiveNoForeign	3	The McDBNode and all of its non-foreign descendants
	mcdbNoLinks	4	Do not follow symbolic links [bit flag]
	mcdbShallowNoLinks	4	The McDBNode and its immediate children for which it is the primary parent
	mcdbRecursiveNoLinks	5	The McDBNode and all of its descendants that can be reached without following a symbolic link
	mcdbShallowNoForeignNoLinks	6	The McDBNode and its immeidate Children that are neither foreign nor symbolically linked
	mcdbRecursiveNoForeignNoLinks	7	The McDBNode and all of its descendants that are neither foreign nor symbolically linked
	mcdbLocal	8	The McDBNode only

Remarks

This method executes a constructed McDBQuery on this McDBNode and [potentially] its Children.

Exceptions

Error Value Description

E_PENDING &H8000000A Query is not properly initialized.

E_UNEXPECTED &H8001FFFF A framework error occurred building the context for the McDBQuery.

E_FAIL &H80004005 Execution of the McDBQuery failed.

CO_E_ATTEMPT_TO_CREATE_OUTSIDE_CLIENT_CONTEXT &H80004024 This McDBNode is not a hierarchy McDBNode (i.e. it is an attribute McDBNode). Attribute McDBNode instances may not be queried.