WoW API: DeleteInboxItem

Revision as of 15:14, 10 January 2007 by WoWWiki>WoWWiki-Tale (initial documentation for DeleteInboxItem)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

WoW API < DeleteInboxItem

Remove a message from the mailbox.

DeleteInboxItem(index)

Parameters

Arguments

index
Number - the index of the message (1 is the first message)

Returns

No return value.

Notes

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.