MQTT_Unsubscribe

Sends MQTT UNSUBSCRIBE for the given list of topic filters to the broker.

MQTTStatus_t MQTT_Unsubscribe( MQTTContext_t * pContext,
                               const MQTTSubscribeInfo_t * pSubscriptionList,
                               size_t subscriptionCount,
                               uint16_t packetId );

Parameters

[in]	pContext	Initialized MQTT context.
[in]	pSubscriptionList	List of MQTT subscription info.
[in]	subscriptionCount	The number of elements in pSubscriptionList.
[in]	packetId	packet ID generated by MQTT_GetPacketId.

Returns

MQTTNoMemory if the MQTTContext_t.networkBuffer 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;
MQTTSubscribeInfo_t unsubscribeList[ NUMBER_OF_SUBSCRIPTIONS ] = { 0 };
uint16_t packetId;
// This context is assumed to be initialized and connected.
MQTTContext_t * pContext;
// This is assumed to be a list of filters we want to unsubscribe from.
const char * filters[ NUMBER_OF_SUBSCRIPTIONS ];
 
// Set information for each unsubscribe request.
for( int i = 0; i < NUMBER_OF_SUBSCRIPTIONS; i++ )
{
     unsubscribeList[ i ].pTopicFilter = filters[ i ];
     unsubscribeList[ i ].topicFilterLength = strlen( filters[ i ] );
 
     // The QoS field of MQTT_SubscribeInfo_t is unused for unsubscribing.
}
 
// Obtain a new packet id for the unsubscribe request.
packetId = MQTT_GetPacketId( pContext );
 
status = MQTT_Unsubscribe( pContext, &unsubscribeList[ 0 ], NUMBER_OF_SUBSCRIPTIONS, packetId );
 
if( status == MQTTSuccess )
{
     // We must now call MQTT_ReceiveLoop() or MQTT_ProcessLoop() to receive the UNSUBACK.
     // After this the broker should no longer send publishes for these topics.
}