QMqttConnectionProperties Class
Die Klasse QMqttConnectionProperties stellt Konfigurationsoptionen dar, die QMqttClient beim Aufruf von QMqttClient::connectToHost() an den Server übergeben kann. Mehr...
Kopfzeile: | #include <QMqttConnectionProperties> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
qmake: | QT += mqtt |
Vererbt von: |
Ö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 |
Detaillierte Beschreibung
Hinweis: Verbindungseigenschaften sind Teil der MQTT 5.0-Spezifikation und können nicht verwendet werden, wenn eine Verbindung mit einer niedrigeren Protokollebene hergestellt wird. Siehe QMqttClient::ProtocolVersion für weitere Informationen.
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 (wenn er sie von QMqttClient::connectionProperties() erhält) oder der Server (wenn er sie von QMqttClient::serverConnectionProperties() erhält) bereit ist, für diese Sitzung gleichzeitig zu verarbeiten.
Siehe auch setMaximumReceive().
quint16 QMqttConnectionProperties::maximumTopicAlias() const
Gibt die maximale Topic-Alias-ID zurück, die der Client verwenden kann.
Siehe auch setMaximumTopicAlias().
bool QMqttConnectionProperties::requestProblemInformation() const
Gibt zurück, ob der Client Probleminformationen erhalten soll.
Siehe auch setRequestProblemInformation().
bool QMqttConnectionProperties::requestResponseInformation() const
Gibt zurück, 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)
Setzt die Authentifizierungsdaten auf authData.
Die Authentifizierungsdaten können nur verwendet werden, wenn eine Authentifizierungsmethode angegeben wurde.
Siehe auch authenticationData() und authenticationMethod().
void QMqttConnectionProperties::setAuthenticationMethod(const QString &authMethod)
Setzt die Authentifizierungsmethode auf authMethod.
Siehe auch authenticationMethod() und authenticationData().
void QMqttConnectionProperties::setMaximumPacketSize(quint32 packetSize)
Setzt die maximale Paketgröße auf packetSize. Die maximale Paketgröße gibt an, wie groß ein Paket maximal sein darf. Dies schließt den Paketkopf und seine Eigenschaften ein.
Wenn keine maximale Paketgröße angegeben wird, gibt es keine Begrenzung, die über die Beschränkungen des Protokolls selbst hinausgeht.
Siehe auch maximumPacketSize().
void QMqttConnectionProperties::setMaximumReceive(quint16 maximumReceive)
Legt die maximale Anzahl von QoS-1- und QoS-2-Veröffentlichungen, die der Client für diese Sitzung gleichzeitig verarbeiten kann, auf maximumReceive fest.
Ein maximaler Empfangswert von 0 ist nicht zulässig.
Siehe auch maximumReceive().
void QMqttConnectionProperties::setMaximumTopicAlias(quint16 alias)
Setzt den maximalen Themen-Alias auf alias. Der maximale Themen-Alias gibt den höchsten Wert an, den der Client vom Server akzeptiert. Der Client verwendet diesen Wert, um die Anzahl der Themen-Aliase zu begrenzen, die er für die Verbindung zu halten bereit ist.
Der Standardwert ist 0. 0 bedeutet, dass der Client keine Themen-Aliasnamen für diese Verbindung akzeptiert.
Siehe auch maximumTopicAlias().
void QMqttConnectionProperties::setRequestProblemInformation(bool problem)
Setzt die Anfrageprobleminformationen auf problem. Ein Client verwendet dies, um den Server aufzufordern, im Falle eines Fehlers zusätzliche Informationen zurückzugeben. Zu den Fehlerarten gehören das Verbindungs- und Nachrichtenmanagement auf der Serverseite.
Der Standardwert ist false
, was bedeutet, dass der Client außer für die Verbindungsverwaltung keine Probleminformationen erhalten darf. Der Server kann dennoch Probleminformationen für das Verbindungsmanagement senden. Wenn der Wert true
lautet, kann der Server Probleminformationen zurücksenden.
Probleminformationen sind in Benutzereigenschaften oder Reason-Strings der Property-Klassen verfügbar.
Siehe auch requestProblemInformation().
void QMqttConnectionProperties::setRequestResponseInformation(bool response)
Setzt die Anfrage-Antwort-Informationen auf response. Ein Client verwendet dies, um den Server aufzufordern, Antwortinformationen zurückzugeben, nachdem die Verbindungsanfrage bearbeitet wurde.
Der Standardwert ist false
, was bedeutet, dass der Client keine Antwortinformationen zurückgeben muss. Wenn der Wert true
ist, kann der Server Antwortinformationen zurückgeben, ist aber nicht dazu gezwungen, dies zu tun.
Siehe auch requestResponseInformation().
void QMqttConnectionProperties::setSessionExpiryInterval(quint32 expiry)
Setzt das Sitzungsablaufintervall auf expiry. Das Sitzungsablaufintervall gibt die Anzahl der Sekunden an, die ein Server Informationen über den Client-Status nach dem Schließen einer Verbindung aufbewahrt.
Der Standardwert ist 0, was bedeutet, dass die Sitzung geschlossen wird, wenn die Netzwerkverbindung beendet wird. Wenn der Wert als Maximum von quint32 angegeben wird, läuft die Sitzung nicht ab.
Siehe auch sessionExpiryInterval().
void QMqttConnectionProperties::setUserProperties(const QMqttUserProperties &properties)
Setzt die Benutzereigenschaften der Verbindung auf properties.
Der Standardwert ist, dass keine Benutzerinformationen gesendet werden.
Siehe auch userProperties().
QMqttUserProperties QMqttConnectionProperties::userProperties() const
Gibt die Benutzereigenschaften für die Verbindung zurück.
Siehe auch setUserProperties().
© 2025 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.