Creates a message port with a unique name.
Item CreateUniqueMsgPort( const char *name, uint8 pri, uint32 signal )
This convenience procedure creates a message port item. It also creates a message queue for the port in system RAM. You can use this procedure in place of CreateItem()
to create the item.
This function works much like CreateMsgPort()
, except that it guarantees that no other message port item of the same name already exists. And once this port created, no other port of the same name will be allowed to be created.
The procedure returns the item number of the new message port or an error code if an error occurs. If a port of the same name already existed when this call was made, the ER_Kr_UniqueItemExists error will be returned.
Convenience call implemented in clib.lib V24.
When you no longer need a message port, use DeleteMsgPort()
to delete it.
You can use FindMsgPort()
to find a message port by name.
CreateMsg
(), DeleteMsg(), DeleteMsgPort(), SendMsg(), SendSmallMsg()