EssOtlGetObjectReferenceCount

Returns the count of outline members referencing the input object handle.

Syntax

ESS_FUNC_M EssOtlGetObjectReferenceCount(hOutline, objHandle, pCount)

Parameter	Data Type	Description
hOutline	ESS_HOUTLINE_T	Outline handle (Edit mode only)
objHandle	ESS_HOBJECT_T	Object handle to be imported or exported
pCount	ESS_ULONG_T*	Count of outline members

Return Value

Returns:

0—If successful
pCount contains values.
Error number—If unsuccessful
pCount is NULL.

Example

void TestGetObjectReferenceCount()
{
	ESS_STS_T		sts = ESS_STS_NOERR;
	ESS_HOUTLINE_T		hOutline = ESS_NULL;
	ESS_OBJDEF_T		Object;
	ESS_HOBJECT_T		hObjHandle = ESS_NULL;
	ESS_ULONG_T			Count = 0;
	ESS_OBJECT_TYPES	objType;
	ESS_STR_T			objName;
	
	memset(&Object, '\0', sizeof(Object)); 
	Object.hCtx = hCtx;
	Object.ObjType = ESS_OBJTYPE_OUTLINE;
	Object.AppName = szAppName;
	Object.DbName = szDbName;
	Object.FileName = szFileName;
 
	sts = EssOtlOpenOutline(hCtx, &Object, 
				ESS_TRUE, ESS_TRUE, &hOutline);
	
	/* Get count of an object that is referenced */
	objType = OBJECT_SMARTLIST;
	objName = "Smartlist1";
	sts = EssOtlFindObject(hOutline, objType, 
				objName, &hObjHandle);
	printf("EssOtlFindObject sts: %ld\n",sts);

	sts = EssOtlGetObjectReferenceCount(hOutline, 
				hObjHandle, &Count);
	printf("EssOtlGetObjectReferenceCount sts: %ld\n",sts);
	printf("\tCount returned: %d\n", Count);

	sts = EssUnlockObject(hCtx, Object.ObjType, 
		Object.AppName, Object.DbName, Object.FileName); 
	sts = EssOtlCloseOutline(hOutline);
}