QtCoap Namespace

Enthält verschiedene Bezeichner, die im Modul Qt CoAP verwendet werden. Mehr...

Kopfzeile:	`#include <QtCoap>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Coap)` `target_link_libraries(mytarget PRIVATE Qt6::Coap)`
qmake:	`QT += coap`

Typen

enum class	Error { Ok, HostNotFound, AddressInUse, TimeOut, BadRequest, …, Unknown }
enum class	Method { Invalid, Get, Post, Put, Delete, Other }
enum class	MulticastGroup { AllCoapNodesIPv4, AllCoapNodesIPv6LinkLocal, AllCoapNodesIPv6SiteLocal }
enum	Port { DefaultPort, DefaultSecurePort }
enum class	ResponseCode { EmptyMessage, Created, Deleted, Valid, Changed, …, InvalidCode }
enum class	SecurityMode { NoSecurity, PreSharedKey, RawPublicKey, Certificate }

Detaillierte Beschreibung

Typ-Dokumentation

enum class QtCoap::Error

Gibt die Fehlerbedingung an, die bei der Bearbeitung der Anfrage festgestellt wurde.

Konstante	Wert	Beschreibung
`QtCoap::Error::Ok`	`0`	Keine Fehlerbedingung.
`QtCoap::Error::HostNotFound`	`1`	Der Name des entfernten Hosts wurde nicht gefunden.
`QtCoap::Error::AddressInUse`	`2`	Die Adresse ist bereits in Gebrauch.
`QtCoap::Error::TimeOut`	`3`	Die Antwort ist nicht rechtzeitig eingetroffen.
`QtCoap::Error::BadRequest`	`4`	Die Anfrage wurde nicht erkannt.
`QtCoap::Error::Unauthorized`	`5`	Der Client ist nicht berechtigt, die angeforderte Aktion durchzuführen.
`QtCoap::Error::BadOption`	`6`	Die Anfrage konnte vom Server aufgrund einer oder mehrerer nicht erkannter oder fehlerhafter Optionen nicht verstanden werden.
`QtCoap::Error::Forbidden`	`7`	Der Zugriff auf diese Ressource ist untersagt.
`QtCoap::Error::NotFound`	`8`	Die angeforderte Ressource wurde nicht gefunden.
`QtCoap::Error::MethodNotAllowed`	`9`	Der Server lässt die für die angeforderte URL verwendete Methode nicht zu.
`QtCoap::Error::NotAcceptable`	`10`	Es wurde keine Ressource gefunden, die den Akzeptanzkriterien der Anfrage entspricht.
`QtCoap::Error::RequestEntityIncomplete`	`11`	Der Server hat die Blöcke des Anforderungskörpers, die er zum Fortfahren benötigt, nicht erhalten. Der Client hat nicht alle Blöcke gesendet, sie nicht in der vom Server geforderten Reihenfolge gesendet oder sie vor so langer Zeit gesendet, dass der Server sie bereits verworfen hat.
`QtCoap::Error::PreconditionFailed`	`12`	Eine oder mehrere Bedingungen, die in den Header-Feldern der Anfrage angegeben sind, wurden beim Test auf dem Server als falsch bewertet.
`QtCoap::Error::RequestEntityTooLarge`	`13`	Die Nutzlast der Anfrage ist größer als der Server verarbeiten kann oder will.
`QtCoap::Error::UnsupportedContentFormat`	`14`	Die Nutzdaten sind in einem Format, das von dieser Methode auf der Zielressource nicht unterstützt wird.
`QtCoap::Error::InternalServerFault`	`15`	Der Server ist auf eine unerwartete Bedingung gestoßen, die ihn daran hindert, die Anforderung zu erfüllen.
`QtCoap::Error::NotImplemented`	`16`	Der Server unterstützt nicht die Funktionalität, die zur Erfüllung der Anfrage erforderlich ist.
`QtCoap::Error::BadGateway`	`17`	Bei einem vorgeschalteten Server ist ein Fehler aufgetreten.
`QtCoap::Error::ServiceUnavailable`	`18`	Der Dienst ist derzeit nicht verfügbar.
`QtCoap::Error::GatewayTimeout`	`19`	Der Server, der als Gateway oder Proxy fungiert, hat keine rechtzeitige Antwort von einem vorgelagerten Server erhalten, auf den er zugreifen musste, um die Anfrage zu erfüllen.
`QtCoap::Error::ProxyingNotSupported`	`20`	Der Server ist nicht in der Lage oder nicht bereit, als Forward-Proxy für den in der Option Proxy-Uri angegebenen URI zu fungieren oder das in Proxy-Scheme angegebene Schema zu verwenden.
`QtCoap::Error::Unknown`	`21`	Ein unbekannter Fehler ist aufgetreten.

enum class QtCoap::Method

Diese Aufzählung spezifiziert CoAP-Anforderungsmethoden.

Konstante	Wert	Beschreibung
`QtCoap::Method::Invalid`	`0`	Die Standard-Anforderungsmethode für eine leere Anforderung.
`QtCoap::Method::Get`	`1`	GET-Methode.
`QtCoap::Method::Post`	`2`	POST-Methode.
`QtCoap::Method::Put`	`3`	PUT-Methode.
`QtCoap::Method::Delete`	`4`	DELETE-Methode.
`QtCoap::Method::Other`	`5`	Andere Anfragemethode.

enum class QtCoap::MulticastGroup

Diese Aufzählung steht für die in RFC 7252 definierten CoAP-Multicast-Gruppenadressen.

Konstante	Wert	Beschreibung
`QtCoap::MulticastGroup::AllCoapNodesIPv4`	`0`	IPv4 "All CoAP Nodes" Adresse 224.0.1.187, aus der "IPv4 Multicast Address Space Registry".
`QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal`	`1`	IPv6 "All CoAP Nodes" link-local scoped address FF02::FD, aus der "IPv6 Multicast Address Space Registry".
`QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal`	`2`	IPv6 "All CoAP Nodes" site-local scoped address FF05::FD, von der "IPv6 Multicast Address Space Registry".

enum QtCoap::Port

Diese Aufzählung gibt die Standardwerte für CoAP-Ports an.

Konstante	Wert	Beschreibung
`QtCoap::DefaultPort`	`5683`	Der Standardport für die nicht sichere Übertragung.
`QtCoap::DefaultSecurePort`	`5684`	Der Standardport, der für die sichere Übertragung verwendet wird.

enum class QtCoap::ResponseCode

Diese Aufzählung stellt den Antwortcode des CoAP-Protokolls dar, wie in RFC 7252 und RFC 7959 definiert.

Konstante	Wert	Beschreibung
`QtCoap::ResponseCode::EmptyMessage`	`0x00`	Der Antwortcode für eine leere Nachricht.
`QtCoap::ResponseCode::Created`	`0x41`	Die Anfrage war erfolgreich und hat dazu geführt, dass neue Ressourcen erstellt wurden. Dieser Antwortcode entspricht dem HTTP 201 "Created".
`QtCoap::ResponseCode::Deleted`	`0x42`	Die Ressource wurde erfolgreich gelöscht. Dieser Antwortcode entspricht HTTP 204 "No Content", wird aber nur als Antwort auf Anfragen verwendet, die dazu führen, dass die Ressource nicht mehr verfügbar ist, wie z. B. DELETE und, unter bestimmten Umständen, POST.
`QtCoap::ResponseCode::Valid`	`0x43`	Dieser Antwortcode entspricht HTTP 304 "Not Modified", wird aber nur verwendet, um anzuzeigen, dass die durch das in der ETag-Option angegebene Entity-Tag identifizierte Antwort gültig ist.
`QtCoap::ResponseCode::Changed`	`0x44`	Die Ressource wurde erfolgreich geändert. Dieser Antwortcode entspricht HTTP 204 "No Content", wird aber nur als Antwort auf POST- und PUT-Anfragen verwendet.
`QtCoap::ResponseCode::Content`	`0x45`	Die Anfrage war erfolgreich. Dieser Antwortcode entspricht HTTP 200 "OK", wird aber nur als Antwort auf GET-Anfragen verwendet.
`QtCoap::ResponseCode::Continue`	`0x5F`	Zeigt an, dass die Übertragung des aktuellen Blocks erfolgreich war und der Server weitere Blöcke senden wird.
`QtCoap::ResponseCode::BadRequest`	`0x-80`	Die Anfrage wurde nicht erkannt. Dieser Antwortcode entspricht HTTP 400 "Bad Request".
`QtCoap::ResponseCode::Unauthorized`	`0x-7f`	Der Client ist nicht berechtigt, die angeforderte Aktion durchzuführen. Dieser Antwortcode entspricht HTTP 401 "Unauthorized".
`QtCoap::ResponseCode::BadOption`	`0x-7e`	Die Anfrage konnte vom Server nicht verstanden werden, da die Optionen nicht erkannt wurden.
`QtCoap::ResponseCode::Forbidden`	`0x-7d`	Der Zugriff auf diese Ressource ist untersagt. Dieser Antwortcode entspricht HTTP 403 "Forbidden".
`QtCoap::ResponseCode::NotFound`	`0x-7c`	Die angeforderte Ressource wurde nicht gefunden. Dieser Antwortcode entspricht HTTP 404 "Not Found".
`QtCoap::ResponseCode::MethodNotAllowed`	`0x-7b`	Der Server lässt die für die angeforderte URL verwendete Methode nicht zu. Dieser Antwortcode entspricht HTTP 405 "Method Not Allowed", jedoch ohne Parallele zum Headerfeld "Allow".
`QtCoap::ResponseCode::NotAcceptable`	`0x-7a`	Es wurde keine Ressource gefunden, die den Akzeptanzkriterien der Anfrage entspricht. Dieser Antwortcode entspricht HTTP 406 "Not Acceptable", jedoch ohne Antwortentität.
`QtCoap::ResponseCode::RequestEntityIncomplete`	`0x-78`	Der Server hat nicht alle Blöcke des Anforderungskörpers erhalten, die er zum Fortfahren benötigt.
`QtCoap::ResponseCode::PreconditionFailed`	`0x-74`	Die in den Header-Feldern der Anfrage angegebenen Vorbedingungen wurden beim Test auf dem Server als `false` ausgewertet. Dieser Antwortcode entspricht HTTP 412 "Vorbedingung fehlgeschlagen".
`QtCoap::ResponseCode::RequestEntityTooLarge`	`0x-73`	Die Nutzlast der Anfrage ist größer als der Server bereit oder in der Lage ist zu verarbeiten. Dieser Antwortcode entspricht HTTP 413 "Request Entity Too Large".
`QtCoap::ResponseCode::UnsupportedContentFormat`	`0x-72`	Der Payload hat ein Format, das von dieser Methode auf der Zielressource nicht unterstützt wird. Dieser Antwortcode entspricht HTTP 415 "Unsupported Media Type".
`QtCoap::ResponseCode::InternalServerFault`	`0x-60`	Der Server ist auf eine unerwartete Bedingung gestoßen, die ihn daran hindert, die Anfrage zu erfüllen. Dieser Antwortcode entspricht HTTP 500 "Internal Server Error".
`QtCoap::ResponseCode::NotImplemented`	`0x-5f`	Der Server unterstützt die zur Erfüllung der Anfrage erforderlichen Funktionen nicht. Dieser Antwortcode entspricht HTTP 501 "Not Implemented".
`QtCoap::ResponseCode::BadGateway`	`0x-5e`	Bei einem vorgeschalteten Server ist ein Fehler aufgetreten. Dieser Antwortcode entspricht HTTP 502 "Bad Gateway".
`QtCoap::ResponseCode::ServiceUnavailable`	`0x-5d`	Der Dienst ist derzeit nicht verfügbar. Dieser Antwortcode entspricht HTTP 503 "Service Unavailable".
`QtCoap::ResponseCode::GatewayTimeout`	`0x-5c`	Der Server, der als Gateway oder Proxy fungiert, hat keine rechtzeitige Antwort von einem vorgelagerten Server erhalten. Dieser Antwortcode entspricht HTTP 504 "Gateway Timeout".
`QtCoap::ResponseCode::ProxyingNotSupported`	`0x-5b`	Der Server ist nicht in der Lage oder nicht willens, als Forward-Proxy für den in der Option Proxy-Uri angegebenen URI oder unter Verwendung des in Proxy-Scheme angegebenen Schemas zu fungieren.
`QtCoap::ResponseCode::InvalidCode`	`0xFF`	Ein ungültiger Antwortcode.

enum class QtCoap::SecurityMode

Gibt den Sicherheitsmodus an, der zur Sicherung einer CoAP-Verbindung verwendet wird, wie in RFC 7252 definiert.

Konstante	Wert	Beschreibung
`QtCoap::SecurityMode::NoSecurity`	`0`	Es gibt keine Sicherheit auf Protokollebene (DTLS ist deaktiviert).
`QtCoap::SecurityMode::PreSharedKey`	`1`	DTLS ist aktiviert. Die PSK-Authentifizierung wird für die Sicherheit verwendet.
`QtCoap::SecurityMode::RawPublicKey`	`2`	DTLS ist aktiviert. Ein asymmetrisches Schlüsselpaar ohne Zertifikat (ein roher öffentlicher Schlüssel) wird für die Sicherheit verwendet. Dieser Modus wird noch nicht unterstützt.
`QtCoap::SecurityMode::Certificate`	`3`	DTLS ist aktiviert. Für die Sicherheit wird ein asymmetrisches Schlüsselpaar mit einem X.509-Zertifikat verwendet.

© 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.