MQTT C Client Libraries Internals: MQTTSubscribe_options Struct Reference

| MQTT C Client Libraries Internals

Data Fields
MQTTSubscribe_options Struct Reference

The MQTT V5 subscribe options, apart from QoS which existed before V5. More...

`#include <MQTTSubscribeOpts.h>`

## Data Fields
char | struct_id [4]
| The eyecatcher for this structure. More...
int | struct_version
| The version number of this structure. More...
unsigned char | noLocal
| To not receive our own publications, set to 1. More...
unsigned char | retainAsPublished
| To keep the retain flag as on the original publish message, set to 1. More...
unsigned char | retainHandling
| 0 - send retained messages at the time of the subscribe (original MQTT behaviour) 1 - send retained messages on subscribe only if the subscription is new 2 - do not send retained messages at all

## Detailed Description

The MQTT V5 subscribe options, apart from QoS which existed before V5.

## Field Documentation

## ◆ noLocal

unsigned char MQTTSubscribe_options::noLocal

To not receive our own publications, set to 1.

0 is the original MQTT behaviour - all messages matching the subscription are received.

## ◆ retainAsPublished

unsigned char MQTTSubscribe_options::retainAsPublished

To keep the retain flag as on the original publish message, set to 1.

If 0, defaults to the original MQTT behaviour where the retain flag is only set on publications sent by a broker if in response to a subscribe request.

## ◆ struct_id

char MQTTSubscribe_options::struct_id[4]

The eyecatcher for this structure.

Must be MQSO.

## ◆ struct_version

int MQTTSubscribe_options::struct_version

The version number of this structure.

Must be 0.

The documentation for this struct was generated from the following file:

- MQTTSubscribeOpts.h