WoW:API TakeInboxItem: Difference between revisions
(upgraded deprecated template) |
(warning that TakeInboxItem() is only a request to do so, and might fail.) |
||
| Line 1: | Line 1: | ||
{{wowapi}} | {{wowapi}} | ||
Sends a request to the server to take an item attachment from a mail message. Note that this is only a request to the server, and the action might fail. Possible reasons for failure include that the users bags are full, that they already have the maximum number of the item they are allowed to have (eg, a unique item), or that a prior TakeInboxItem() request is still being processed by the server. There may be other reasons for failure. | |||
''Syntax'' | ''Syntax'' | ||
---- | ---- | ||
| Line 10: | Line 13: | ||
---- | ---- | ||
Always returns nil. | Always returns nil. (note: please confirm) As the request is done to the server asynchronously and might fail, then if knowing whether the action was successful is important, you will need to check afterward that it was. | ||
(note: please confirm) | |||
| Line 21: | Line 22: | ||
</pre> | </pre> | ||
Would take the attachment from the first message in the Inbox and place it in the next available container slot. | Would attempt to take the attachment from the first message in the Inbox and place it in the next available container slot. | ||
Revision as of 14:23, 9 January 2007
← WoW API < TakeInboxItem
Sends a request to the server to take an item attachment from a mail message. Note that this is only a request to the server, and the action might fail. Possible reasons for failure include that the users bags are full, that they already have the maximum number of the item they are allowed to have (eg, a unique item), or that a prior TakeInboxItem() request is still being processed by the server. There may be other reasons for failure.
Syntax
TakeInboxItem(index)
index - the index of the mailbox message you want to take the item attachment from.
Returns
Always returns nil. (note: please confirm) As the request is done to the server asynchronously and might fail, then if knowing whether the action was successful is important, you will need to check afterward that it was.
Example
TakeInboxItem(1)
Would attempt to take the attachment from the first message in the Inbox and place it in the next available container slot.