MQTT_Publish

Publishes a message to the given topic name.

MQTTStatus_t MQTT_Publish( MQTTContext_t * pContext,
                           const MQTTPublishInfo_t * pPublishInfo,
                           uint16_t packetId );

Parameters

[in]	pContext	Initialized MQTT context.
[in]	pPublishInfo	MQTT PUBLISH packet parameters.
[in]	packetId	packet ID generated by MQTT_GetPacketId.

Returns

MQTTNoMemory if pBuffer is too small to hold the MQTT packet; MQTTBadParameter if invalid parameters are passed; MQTTSendFailed if transport write failed; MQTTSuccess otherwise.

Example

// Variables used in this example.
MQTTStatus_t status;
MQTTPublishInfo_t publishInfo;
uint16_t packetId;
// This context is assumed to be initialized and connected.
MQTTContext_t * pContext;
 
// QoS of publish.
publishInfo.qos = MQTTQoS1;
publishInfo.pTopicName = "/some/topic/name";
publishInfo.topicNameLength = strlen( publishInfo.pTopicName );
publishInfo.pPayload = "Hello World!";
publishInfo.payloadLength = strlen( "Hello World!" );
 
// Packet ID is needed for QoS > 0.
packetId = MQTT_GetPacketId( pContext );
 
status = MQTT_Publish( pContext, &publishInfo, packetId );
 
if( status == MQTTSuccess )
{
     // Since the QoS is > 0, we will need to call MQTT_ReceiveLoop()
     // or MQTT_ProcessLoop() to process the publish acknowledgments.
}