public final class ChatMessageDestroy extends BbmdsProtocol.OutboundMessage
Request that one or many 'chatMessage' entries previously sent by the local user's identity be recalled and destroyed from:
An outgoing message can be destroyed regardless of its delivery state, except that requests to destroy a 'chatMessage' in 'state' 'Failed' will be ignored.
The 'chatMessage' 'recall' state will be updated to reflect the state of the process on the sender endpoint and all recipients' endpoints. There is no guarantee that the recipients have not read the message prior to it being destroyed.
|Constructor and Description|
Creates a new outbound 'chatMessageDestroy' message.
|Modifier and Type||Method and Description|
Sets the optional 'messageId' attribute on the message
public ChatMessageDestroy(java.lang.String chatId)
chatId- The id of the chat containing the message to be recalled and destroyed.
public ChatMessageDestroy messageId(long value)
When present, this is the id of an individual 'chatMessage' that is to be recalled and destroyed within the indicated chat. Only "content" messages can be identified with a 'messageId'. Thus, 'chatMessage' entries with 'tag' values such as 'Admin', 'Gap', 'Join', 'Leave', 'Remove', 'Shred', and 'Subject' cannot be destroyed by indiciating their individual 'messageId'.
When not present, all 'chatMessage' entries that have been previously sent by the local user's identity will be recalled and destroyed. Plus, all non-"content" messages (including control messages with the 'tag' values listed above) that have been sent by the local user's identity within the indicated chat will be destroyed from the BlackBerry Infrastructure. Thus, endpoints that have not yet received those control messages shall never receive them or make them available to your application.