Remove a message from the mailbox.
- Number - the index of the message (1 is the first message)
No return value.
DeleteInboxItem is a function that asynchronously requests the server to remove a message from the mailbox. It returns immediately, with confirmation coming via a MAIL_INBOX_UPDATE event. This request can fail. Besides the obvious case of the index not referring to a valid message number, it can fail if another DeleteInboxItem action is already in progress, and perhaps in other cases.
DeleteInboxItem is an unconditional request; the server does not check whether the message still has an item or money attached. The confirmation box that appears in game for these conditions is triggered by InboxItemCanDelete, before calling DeleteInboxItem. Note that InboxItemCanDelete is not a permission-checking function, it is just an API for determining whether a message is returnable (and thus has a misleading name). All messages are deletable.