MQTTc_Subscribe
Send a 'Subscribe' message to MQTT server.
Files
mqtt-c.h/mqtt-c.c
Prototype
void MQTTc_Subscribe ( MQTTc_CONN *p_conn, MQTTc_MSG *p_msg, const CPU_CHAR *topic_str, CPU_INT08U req_qos, MQTTc_ERR *p_err);
Arguments
p_conn
Pointer to MQTTc Connection to use.
p_msg
Pointer to MQTTc Message object to use.
topic_str
String containing the topic at which to subscribe. Must stay valid until the message has been completely sent.
req_qos
Requested level of QoS for this subscription.
payload_str
String containing the payload to publish. Must stay valid until the message has been completely sent.
p_err
Pointer to variable that will receive the return error code from this function:
MQTTc_ERR_NONE
MQTTc_ERR_NOT_INIT
MQTTc_ERR_NULL_PTR
MQTTc_ERR_INVALID_ARG
MQTTc_ERR_INVALID_BUF_SIZE
MQTTc_ERR_FAIL
Returned Values
None.
Required Configuration
None.
Notes / Warnings
- This function MUST be called after the µC/MQTT-client initialization has been completed.
- Both the
MQTTc_CONN
object and theMQTTc_MSG
object used MUST stay valid until the message has completed (callback has been called).