Method FreeHandle

core/logic/HandleSys.cpp:679–749

}

HandleError HandleSystem::FreeHandle(QHandle *pHandle, unsigned int index)
{
	if (pHandle->is_destroying)
	{
		/* Someone tried to free this recursively.  
		 * We'll just ignore this safely.
		 */
		return HandleError_None;
	}

	QHandleType *pType = &m_Types[pHandle->type];

	if (pHandle->owner && pHandle->owner->num_handles > 0)
		pHandle->owner->num_handles--;

	if (pHandle->clone)
	{
		/* If we're a clone, decrease the parent reference count */
		QHandle *pMaster;
		unsigned int master;

		/* Note that if we ever have per-handle security, we would need to re-check
		* the access on this Handle. */
		master = pHandle->clone;
		pMaster = &m_Handles[master];

		/* Release the clone now */
		pHandle->is_destroying = true;
		ReleasePrimHandle(index);

		/* Decrement the master's reference count */
		if (--pMaster->refcount == 0)
		{
			/* Type should be the same but do this anyway... */
			pType = &m_Types[pMaster->type];
			pMaster->is_destroying = true;
			if (pMaster->object)
			{
				pType->dispatch->OnHandleDestroy(pMaster->type, pMaster->object);
			}
			ReleasePrimHandle(master);
		}
	} else if (pHandle->set == HandleSet_Identity) {
		/* If we're an identity, skip all this stuff!
		 * NOTE: SHARESYS DOES NOT CARE ABOUT THE DESTRUCTOR
		 */
		pHandle->is_destroying = true;
		ReleasePrimHandle(index);
	} else {
		/* Decrement, free if necessary */
		if (--pHandle->refcount == 0)
		{
			pHandle->is_destroying = true;
			if (pHandle->object)
			{
				pType->dispatch->OnHandleDestroy(pHandle->type, pHandle->object);
			}
			ReleasePrimHandle(index);