Event_FileXferInvitationUpdate

This notification notifies the sender that the recipient has been accepted or declined the file transfer, or that the invitation has expired. Based on the status of the event, one of the following actions occur:
  • If the file transfer is accepted, file transfer initiates.
  • If the file transfer is declined, no action is completed.
  • If the file transfer invitation expires, the sender can send another invitation.

Parameter

Type

Description

status

String

This parameter specifies a status of 'Accepted', 'Declined', or 'Expired'.

fileId

String

This parameter specifies the file ID created by the BlackBerry Connect client for the file. This value is passed to the AcceptFileXfer method. For more information, see METHOD_AcceptFileXfer.

method

String

This parameter returns the invoked method (for example, FileXferInvitationUpdate).

Code example

If the notification is successful, BEMS sends the following notification to the BlackBerry Connect app and includes the invitation status for the file. In the following example, the recipient accepted the file and the file is sent using the MSNFTP protocol. 

{
  "id":"S38",
  "error":null,
  "result":
   {
    "data":
     {
      "fileId":"dbc2e7b6-25e8-450e-9670-c9e4f32341bb",
      "status":"Accepted",
      "method":"FileXferInvitationUpdate",
      "state":"COMPLETE" 
     }
   },
  "jsonrpc":"2.0"
}