Command
QisLib_GetStructureTree

QisLib_GetStructureTree

Function:
	int QisLib_GetStructureTree(const char* StructName, int NestingL);

Inputs:
	StructName: Name of the cell in question.
	NestingL: value >= 0 indicating the Nesting level (cell reference hierarchy
	level).(_QISNL_ALL indicates all nesting levels).

Return:
	success: 0
	failure: one of the following values :

Errors:
	-1: QisLib has not been initialized.
	-2: The callback function to handle vector data has not been set.
	-3: Internal error occurred while processing cell tree.
	-4: The cell name is invalid (null).
	-5: File open in progress, operation not permitted.

Description:
	- This function can be used to get cell references and array references within the
	specified cell.
	- The 'NestingL' parameter controls how far down the cell reference hierarchy should
	QisLib look for cell/ array references. This value must be greater than or equal to
	0 or _QISNL_ALL.
	- The vector data is returned by calling a handler function set by the user program
	using QisLib_SetVectorDataCallback.This handler function must be set before using
	this function.
	- Each reference's transformation data is also included in the data returned.
	- This function is not affected by display filters, window settings , array mode
	settings etc.
	- It returns references even if QisLib_SetReferenceVectorFormat is set to 'off'.
	- However, QisLib_SetReferenceVectorFormat and QisLib_SetVectorGrandParents can be
	used to specify the amount.
	- To interrupt this function while it is returning data, the user program can call
	QisLib_Stop. This feature can only be used if QisLib_SetProcessEvents is on and for
	Unix/Linux, the program's application context was passed as a parameter to
	QisLib_InitLib.