Method Remove

Include/XnHash.h:466–481

* Remove a key-value entry from the XnHash * * @param key [in] The key of the entry * @param value [out] The value that was in the removed entry * @return XN_STATUS_NO_MATCH if no such key exists */

	* @return	XN_STATUS_NO_MATCH	if no such key exists	
	*/
	XnStatus Remove(const XnKey& key, XnValue& value)
	{
		// find the entry to which the key belongs
		Iterator hiter(this);

		XnStatus FindStatus = Find(key, hiter);
		if (FindStatus != XN_STATUS_OK)
		{
			// no such entry!
			return FindStatus;
		}

		// Remove by iterator
		value = hiter.Value();
		return Remove(hiter);
	}

	/**
	* Remove an entry from the XnHash by iterator