Description

Return an McDBNode with a given global specifier.

Return Type

A McDBNode object.  

Syntax

object.RetrieveNode (GlobalIdorPath)

The RetrieveNode Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBDatabases.
GlobalIdorPathRequired. A String value.

A McDBNode identifier, either an Id or Path. This identifier must be of global form (i.e. including a database qualifier, which may be either a fully qualified database path or database Id).

Remarks

If the database in the global specifier is not open or not in this McDBDatabases collection, it will be added to this collection and opened, as necessary. This McDBDatabase will remain open even if the Id portion of GlobalIdorPath is invalid (i.e. this method returned Nothing).

Exceptions

Error Value Description
E_INVALIDARG &H80070057 GlobalIdorPath contains an invalid database identifier.

Notes

This method can be used to retrieve attribute McDBNode instances directly, rather than requiring the owning McDBNode to be instantiated and its McDBNode.Attributes collection be searched. Attribute McDBNode instances may only be retrieved by Id.