General functions such as creation and deletion.
Checks if a metanode handle is valid (that is, pointing at a metanode and not closed)
handle to check
0 if invalid, 1 if valid
Closes a handle to a metanode.
Copies a metanode internally in the API (that is, makes a new one with the same properties but doesn't give it to vrtree) It does this so that a migration can then modify it before VRFinishMetaNode is called as usual to instantiate it properly.
handle to the metanode to copy
automatically increments the version number by this much (negative for decrement)
Performs migrations of a metanode to create all known versions between start and end.
handle to the metanode to use as the starting point for migrations
handle to the metanode to migrate to (versions are created until this version, but does not create this version)
int the number of intermediate metanodes that exist between the requested versions, or -1 on failure
Uses the version of start to begin - if end is > start, up migrations are used, otherwise down migrations are used.
Creates a metanode (a description of a node structure).
Metanodes start at version 0, and their version is incremented by VRAddMigration.
Once a metanode has been instantiated (by creating a Node of this type), no further modifications are allowed to its structure.
the name of the new metanode
a handle to the metanode, for use with other metanode functions
Creates a metanode (a description of a node structure) with additional flags.
the flags to apply
Gets the name of the current version of the specified metanode.
the name of the metanode (no version suffix)
the variable to recieve the name of the current version of this metanode
size of the output buffer
number of bytes written to outputBuffer
if buffer is null, function returns the required size of the buffer
Deletes a metanode. Can only be done if there are no instances of the metanode and the metanode structure has not been passed to vrtree.
handle to the metanode to delete
0 on success. If successful, the handle is closed automatically
Finishes a metanode definition by passing it to VRTree.
At this point, modifications to the metanode can no longer be made because the total number of migrations is used to set the metanode version.
handle to the metanode to finish. this handle is closed by this function
0 on success
a new handle to the real metanode
Gets the name of a metanode.
handle to the metanode
a buffer to receive the node name as a null terminated string
size of the buffer
the number of characters written to the buffer (including trailing null)
Gets the length of a metanode's name, plus 1 for the trailing null terminator.