Subscribes to the given array of topic filters with a timeout.

IotMqttError_t IotMqtt_SubscribeSync( IotMqttConnection_t mqttConnection,
                                      const IotMqttSubscription_t * pSubscriptionList,
                                      size_t subscriptionCount,
                                      uint32_t flags,
                                      uint32_t timeoutMs );

This function sends an MQTT SUBSCRIBE packet to the server, then waits for a server response to the packet. Internally, this function is a call to IotMqtt_SubscribeAsync followed by IotMqtt_Wait. See IotMqtt_SubscribeAsync for more information about the MQTT SUBSCRIBE operation.

Attention: QoS 2 subscriptions are currently unsupported. Only 0 or 1 are valid for subscription QoS.

Parameters

[in]	mqttConnection	The MQTT connection to use for the subscription.
[in]	pSubscriptionList	Pointer to the first element in the array of subscriptions.
[in]	subscriptionCount	The number of elements in pSubscriptionList.
[in]	flags	Flags which modify the behavior of this function. See MQTT Function Flags. Currently, flags are ignored by this function; this parameter is for future-compatibility.
[in]	timeoutMs	If the MQTT server does not acknowledge the subscriptions within this timeout in milliseconds, this function returns IOT_MQTT_TIMEOUT.

Returns

One of the following: