kStatus kMsgQueue_Add	(	kMsgQueue	queue,
		void *	item
	)

Adds an item to the queue.

If queue capacity is exceeded, the oldest item in the queue will be removed. If a drop handler is installed, the handler will be called; otherwise, if the queue is an object container, then kObject_Dispose will be used to dispose the item.

If the operation status returned by this function indicates an error, it is the responsibility of the caller to dispose the item (if appropriate).

Parameters

queue	Queue object.
item	Item to be added.

Returns

Operation status.