Auf dieser Seite

QMqttConnectionProperties Class

Die Klasse „QMqttConnectionProperties“ stellt Konfigurationsoptionen dar, die ein „ QMqttClient “ beim Aufruf von „ QMqttClient::connectToHost()“ an den Server übergeben kann. Mehr...

Header: #include <QMqttConnectionProperties>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt
Vererbt an:

QMqttServerConnectionProperties

Öffentliche Funktionen

QByteArray authenticationData() const
QString authenticationMethod() const
quint32 maximumPacketSize() const
quint16 maximumReceive() const
quint16 maximumTopicAlias() const
bool requestProblemInformation() const
bool requestResponseInformation() const
quint32 sessionExpiryInterval() const
void setAuthenticationData(const QByteArray &authData)
void setAuthenticationMethod(const QString &authMethod)
void setMaximumPacketSize(quint32 packetSize)
void setMaximumReceive(quint16 maximumReceive)
void setMaximumTopicAlias(quint16 alias)
void setRequestProblemInformation(bool problem)
void setRequestResponseInformation(bool response)
void setSessionExpiryInterval(quint32 expiry)
void setUserProperties(const QMqttUserProperties &properties)
QMqttUserProperties userProperties() const

Ausführliche Beschreibung

Hinweis: Verbindungseigenschaften sind Teil der MQTT 5.0-Spezifikation und können bei einer Verbindung auf einer niedrigeren Protokollebene nicht verwendet werden. Weitere Informationen finden Sie unter QMqttClient::ProtocolVersion.

Dokumentation der Mitgliedsfunktionen

QByteArray QMqttConnectionProperties::authenticationData() const

Gibt die Authentifizierungsdaten zurück.

Siehe auch setAuthenticationData().

QString QMqttConnectionProperties::authenticationMethod() const

Gibt die Authentifizierungsmethode zurück.

Siehe auch setAuthenticationMethod().

quint32 QMqttConnectionProperties::maximumPacketSize() const

Gibt die maximale Paketgröße zurück, die der Client empfangen kann.

Siehe auch „ setMaximumPacketSize()“.

quint16 QMqttConnectionProperties::maximumReceive() const

Gibt die maximale Anzahl von QoS-1- und QoS-2-Veröffentlichungen zurück, die der Client (bei Abruf über QMqttClient::connectionProperties()) bzw. der Server (bei Abruf über QMqttClient::serverConnectionProperties()) für diese Sitzung gleichzeitig verarbeiten möchte.

Siehe auch setMaximumReceive().

quint16 QMqttConnectionProperties::maximumTopicAlias() const

Gibt die maximale Themen-Alias-ID zurück, die der Client verwenden kann.

Siehe auch „ setMaximumTopicAlias()“.

bool QMqttConnectionProperties::requestProblemInformation() const

Gibt zurück, ob der Client Informationen zu Problemen erhalten soll.

Siehe auch „ setRequestProblemInformation()“.

bool QMqttConnectionProperties::requestResponseInformation() const

Gibt an, ob der Client Antwortinformationen erhalten soll.

Siehe auch „ setRequestResponseInformation()“.

quint32 QMqttConnectionProperties::sessionExpiryInterval() const

Gibt das Ablaufintervall der Sitzung zurück.

Siehe auch ` setSessionExpiryInterval()`.

void QMqttConnectionProperties::setAuthenticationData(const QByteArray &authData)

Legt die Authentifizierungsdaten auf „ authData “ fest.

Authentifizierungsdaten können nur verwendet werden, wenn eine Authentifizierungsmethode angegeben wurde.

Siehe auch authenticationData() und authenticationMethod().

void QMqttConnectionProperties::setAuthenticationMethod(const QString &authMethod)

Legt die Authentifizierungsmethode auf „ authMethod “ fest.

Siehe auch authenticationMethod() und authenticationData().

void QMqttConnectionProperties::setMaximumPacketSize(quint32 packetSize)

Legt die maximale Paketgröße auf „ packetSize “ fest. Die maximale Paketgröße gibt die größte Größe an, die ein Paket haben darf. Dies umfasst den Paket-Header und dessen Eigenschaften.

Wenn keine maximale Paketgröße angegeben wird, gibt es keine Beschränkung über die Einschränkungen des Protokolls selbst hinaus.

Siehe auch ` maximumPacketSize()`.

void QMqttConnectionProperties::setMaximumReceive(quint16 maximumReceive)

Legt die maximale Anzahl von QoS-1- und QoS-2-Veröffentlichungen fest, die der Client für diese Sitzung gleichzeitig verarbeiten möchte, und setzt sie auf „ maximumReceive “.

Ein maximaler Empfangswert von 0 ist nicht zulässig.

Siehe auch maximumReceive().

void QMqttConnectionProperties::setMaximumTopicAlias(quint16 alias)

Legt den maximalen Themenalias auf „ alias “ fest. Der maximale Themenalias gibt den höchsten Wert an, den der Client vom Server akzeptiert. Der Client verwendet diesen Wert, um die Anzahl der Themenalias zu begrenzen, die er für die Verbindung vorhalten möchte.

Der Standardwert ist 0. Der Wert 0 bedeutet, dass der Client bei dieser Verbindung keine Themenaliase akzeptiert.

Siehe auch ` maximumTopicAlias()`.

void QMqttConnectionProperties::setRequestProblemInformation(bool problem)

Setzt die Informationen zu Fehlermeldungen bei Anfragen auf „ problem “. Ein Client nutzt diese Einstellung, um den Server aufzufordern, im Falle eines Fehlers zusätzliche Informationen zurückzugeben. Zu den Fehlerarten zählen Probleme bei der Verbindungs- und Nachrichtenverwaltung auf der Serverseite.

Der Standardwert ist „ false “, was bedeutet, dass der Client keine Fehlerinformationen erhalten darf, außer solchen, die die Verbindungsverwaltung betreffen. Der Server kann dennoch Fehlerinformationen zur Verbindungsverarbeitung senden. Wenn der Wert „ true “ lautet, kann der Server Fehlerinformationen zurückgeben.

Fehlerinformationen sind in den Benutzereigenschaften oder in den Begründungszeichenfolgen der Eigenschaftsklassen verfügbar.

Siehe auch ` requestProblemInformation()`.

void QMqttConnectionProperties::setRequestResponseInformation(bool response)

Legt die Informationen zur Antwort auf die Anfrage auf „ response “ fest. Ein Client verwendet diese Einstellung, um den Server aufzufordern, nach der Bearbeitung der Verbindungsanfrage Antwortinformationen zurückzugeben.

Der Standardwert ist „ false “, was bedeutet, dass der Client keine Antwortinformationen zurückgeben darf. Ist der Wert „ true “, darf der Server Antwortinformationen zurückgeben, ist jedoch nicht dazu verpflichtet.

Siehe auch requestResponseInformation().

void QMqttConnectionProperties::setSessionExpiryInterval(quint32 expiry)

Legt das Ablaufintervall der Sitzung auf „ expiry “ fest. Das Ablaufintervall der Sitzung gibt an, wie viele Sekunden ein Server Informationen zum Client-Status aufbewahrt, nachdem eine Verbindung geschlossen wurde.

Der Standardwert ist 0, was bedeutet, dass die Sitzung geschlossen wird, sobald die Netzwerkverbindung beendet wird. Wird der Wert auf maximal „quint32“ festgelegt, läuft die Sitzung nicht ab.

Siehe auch ` sessionExpiryInterval()`.

void QMqttConnectionProperties::setUserProperties(const QMqttUserProperties &properties)

Legt die Benutzereigenschaften der Verbindung zu properties fest.

Standardmäßig werden keine Benutzerinformationen gesendet.

Siehe auch userProperties().

QMqttUserProperties QMqttConnectionProperties::userProperties() const

Gibt die Benutzereigenschaften für die Verbindung zurück.

Siehe auch „ setUserProperties()“.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.