Description

Search McDBNode instances in this McDBNodes collection.

Return Type

A McDBNodes object.  

Syntax

object.FindNodes (Query, [mode])

The FindNodes Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBNodes.
QueryRequired. A McDBQuery object.

The McDBQuery specifying the McDBNodes to match and return

modeOptional. A mcDBQueryMode enumeration, as described in settings.

Whether the query should recurse the McDBNode.Children of the McDBNode instances in this collection.

Settings

The settings for mode are:

ConstantValueDescription
 mcdbShallow0

The McDBNode and its immediate Children

 mcdbRecursive1

The McDBNode and all of its descendants

 mcdbNoForeign2

Do not include foreign references [bit flag]

 mcdbShallowNoForeign2

The McDBNode and all of its non-foreign children

 mcdbRecursiveNoForeign3

The McDBNode and all of its non-foreign descendants

 mcdbNoLinks4

Do not follow symbolic links [bit flag]

 mcdbShallowNoLinks4

The McDBNode and its immediate children for which it is the primary parent

 mcdbRecursiveNoLinks5

The McDBNode and all of its descendants that can be reached without following a symbolic link

 mcdbShallowNoForeignNoLinks6

The McDBNode and its immeidate Children that are neither foreign nor symbolically linked

 mcdbRecursiveNoForeignNoLinks7

The McDBNode and all of its descendants that are neither foreign nor symbolically linked

 mcdbLocal8

The McDBNode only

Remarks

This method executes a constructed McDBQuery on the McDBNode instances in this collection and [potentially] their children.

Exceptions

Error Value Description
E_UNEXPECTED &H8001FFFF A framework error occurred during construction of the set of McDBNodes being queried or returned.
E_PENDING &H8000000A Query is not properly initialized, possibly because one or more McDBNode instances in Query did not have their McDBDatabase attached to it using McDBQuery.AttachDatabase().
E_FAIL &H80004005 Execution of the McDBQuery failed.

Notes

This method is especially useful for refining queries (see the example)