TIM SDK
TIM API C
third_party_app_payload.h File Reference

Description

Third party app payload.

Object type third_party_app_payload.

Functions

ta_e_result_code_t ta_third_party_app_payload_create (ta_object_t *third_party_app_payload, ta_e_third_party_app_id_t third_party_app_id, ta_object_t data)
 Create object of type third_party_app_payload. More...
 
ta_e_result_code_t ta_third_party_app_payload_get_third_party_app_id (ta_object_t response, ta_e_third_party_app_id_t *third_party_app_id)
 Third party app id. More...
 
ta_e_result_code_t ta_third_party_app_payload_get_data (ta_object_t response, ta_object_t *data)
 Third party app payload data. More...
 

Function Documentation

◆ ta_third_party_app_payload_create()

ta_e_result_code_t ta_third_party_app_payload_create ( ta_object_t third_party_app_payload,
ta_e_third_party_app_id_t  third_party_app_id,
ta_object_t  data 
)

Create object of type third_party_app_payload.

Parameters
[out]third_party_app_payloadPointer to variable to write created object instance to. Created object instance is retained.
[in]third_party_app_idThird party app id.
[in]dataData. Object of type string.
Return values
ta_c_rc_okObject instance has been created and written to third_party_app_payload.
ta_c_rc_invalid_argumentthird_party_app_payload is null-pointer.
ta_c_rc_invalid_argumentthird_party_app_id is not a valid value from ta_e_third_party_app_id_t.
ta_c_rc_invalid_argumentdata is ta_object_invalid or not of type string.
ta_c_rc_out_of_memoryFailed allocating memory.

◆ ta_third_party_app_payload_get_data()

ta_e_result_code_t ta_third_party_app_payload_get_data ( ta_object_t  response,
ta_object_t data 
)

Third party app payload data.

Parameters
[in]responseObject instance of type third_party_app_payload.
[out]dataPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in response.
Return values
ta_c_rc_okObject instance written to data.
ta_c_rc_invalid_argumentresponse is ta_object_invalid.
ta_c_rc_invalid_argumentresponse is not of type third_party_app_payload.
ta_c_rc_invalid_argumentdata is null-pointer.

◆ ta_third_party_app_payload_get_third_party_app_id()

ta_e_result_code_t ta_third_party_app_payload_get_third_party_app_id ( ta_object_t  response,
ta_e_third_party_app_id_t third_party_app_id 
)

Third party app id.

Parameters
[in]responseObject instance of type third_party_app_payload.
[out]third_party_app_idPointer to variable to write value to.
Return values
ta_c_rc_okValue written to third_party_app_id.
ta_c_rc_invalid_argumentresponse is ta_object_invalid.
ta_c_rc_invalid_argumentresponse is not of type third_party_app_payload.
ta_c_rc_invalid_argumentthird_party_app_id is null-pointer.