QtCoap Namespace

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

Header:	`#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 }

Ausführliche Beschreibung

Typdokumentation

enum class QtCoap::Error

Gibt den Fehlerzustand an, der bei der Verarbeitung der Anfrage festgestellt wurde.

Konstante	Wert	Beschreibung
`QtCoap::Error::Ok`	`0`	Kein Fehlerzustand.
`QtCoap::Error::HostNotFound`	`1`	Der Name des Remote-Hosts wurde nicht gefunden.
`QtCoap::Error::AddressInUse`	`2`	Die Adresse wird bereits verwendet.
`QtCoap::Error::TimeOut`	`3`	Die Antwort ist nicht rechtzeitig eingegangen.
`QtCoap::Error::BadRequest`	`4`	Die Anfrage wurde nicht erkannt.
`QtCoap::Error::Unauthorized`	`5`	Der Client ist nicht berechtigt, die angeforderte Aktion auszuführen.
`QtCoap::Error::BadOption`	`6`	Die Anfrage konnte vom Server aufgrund einer oder mehrerer unbekannter 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 die Akzeptanzkriterien der Anfrage erfüllt.
`QtCoap::Error::RequestEntityIncomplete`	`11`	Der Server hat nicht alle Blöcke des Anfragetextes erhalten, die er zur weiteren Bearbeitung benötigt. Der Client hat entweder nicht alle Blöcke gesendet, hat sie nicht in der vom Server geforderten Reihenfolge gesendet oder hat sie vor so langer Zeit gesendet, dass der Server sie bereits verworfen hat.
`QtCoap::Error::PreconditionFailed`	`12`	Eine oder mehrere in den Header-Feldern der Anfrage angegebene Bedingungen wurden bei der Überprüfung auf dem Server als „false“ ausgewertet.
`QtCoap::Error::RequestEntityTooLarge`	`13`	Die Nutzlast der Anfrage ist größer, als der Server verarbeiten will oder kann.
`QtCoap::Error::UnsupportedContentFormat`	`14`	Die Nutzlast liegt in einem Format vor, das von dieser Methode für die Zielressource nicht unterstützt wird.
`QtCoap::Error::InternalServerFault`	`15`	Der Server ist auf eine unerwartete Situation gestoßen, die ihn daran gehindert hat, die Anfrage zu erfüllen.
`QtCoap::Error::NotImplemented`	`16`	Der Server unterstützt die zur Erfüllung der Anfrage erforderliche Funktionalität nicht.
`QtCoap::Error::BadGateway`	`17`	Bei einem vorgelagerten 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 abzuschließen.
`QtCoap::Error::ProxyingNotSupported`	`20`	Der Server kann oder will nicht als Forward-Proxy für die in der Option „Proxy-Uri“ angegebene URI oder unter Verwendung des in „Proxy-Scheme“ angegebenen Schemas fungieren.
`QtCoap::Error::Unknown`	`21`	Es ist ein unbekannter Fehler aufgetreten.

enum class QtCoap::Method

Diese Enumeration legt die CoAP-Anforderungsmethoden fest.

Konstante	Wert	Beschreibung
`QtCoap::Method::Invalid`	`0`	Die Standard-Anfragemethode für eine leere Anfrage.
`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 Enumeration stellt die in RFC 7252 definierten CoAP-Multicast-Gruppenadressen dar.

Konstante	Wert	Beschreibung
`QtCoap::MulticastGroup::AllCoapNodesIPv4`	`0`	IPv4-Adresse „All CoAP Nodes“ 224.0.1.187, aus dem „IPv4 Multicast Address Space Registry“.
`QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal`	`1`	IPv6-Adresse „Alle CoAP-Knoten“ im Link-Local-Bereich: FF02::FD, aus dem „IPv6 Multicast Address Space Registry“.
`QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal`	`2`	IPv6-Adresse „Alle CoAP-Knoten“ im Site-Local-Bereich FF05::FD, aus dem „IPv6-Multicast-Adressraum-Register“.

enum QtCoap::Port

Diese Enumeration legt die Standardwerte für die CoAP-Ports fest.

Konstante	Wert	Beschreibung
`QtCoap::DefaultPort`	`5683`	Der Standardport für die ungesicherte Übertragung.
`QtCoap::DefaultSecurePort`	`5684`	Der Standardport für die sichere Übertragung.

enum class QtCoap::ResponseCode

Diese Enumeration stellt den Antwortcode des CoAP-Protokolls dar, wie er in RFC 7252 und RFC 7959 definiert ist.

Konstante	Wert	Beschreibung
`QtCoap::ResponseCode::EmptyMessage`	`0x00`	Der Antwortcode für eine leere Nachricht.
`QtCoap::ResponseCode::Created`	`0x41`	Die Anfrage war erfolgreich und hat zur Erstellung neuer Ressourcen geführt. Dieser Antwortcode entspricht HTTP 201 „Created“.
`QtCoap::ResponseCode::Deleted`	`0x42`	Die Ressource wurde erfolgreich gelöscht. Dieser Antwortcode entspricht dem HTTP-Code 204 „No Content“, wird jedoch 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 steht im Zusammenhang mit HTTP 304 „Not Modified“, wird jedoch nur verwendet, um anzuzeigen, dass die durch den in der ETag-Option angegebenen 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 jedoch nur als Antwort auf POST- und PUT-Anfragen verwendet.
`QtCoap::ResponseCode::Content`	`0x45`	Die Anfrage war erfolgreich. Dieser Antwortcode entspricht dem HTTP-Code 200 „OK“, wird jedoch 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 auszuführen. Dieser Antwortcode entspricht HTTP 401 „Unauthorized“.
`QtCoap::ResponseCode::BadOption`	`0x-7e`	Die Anfrage konnte vom Server aufgrund unbekannter Optionen nicht verstanden werden.
`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 Entsprechung zum „Allow“-Header-Feld.
`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 zur Weiterverarbeitung benötigt.
`QtCoap::ResponseCode::PreconditionFailed`	`0x-74`	Die in den Anforderungs-Header-Feldern angegebenen Vorbedingungen wurden bei der Prüfung auf dem Server als „ `false` “ bewertet. Dieser Antwortcode entspricht HTTP 412 „Precondition Failed“.
`QtCoap::ResponseCode::RequestEntityTooLarge`	`0x-73`	Die Nutzlast der Anfrage ist größer, als der Server verarbeiten will oder kann. Dieser Antwortcode entspricht HTTP 413 „Request Entity Too Large“.
`QtCoap::ResponseCode::UnsupportedContentFormat`	`0x-72`	Die Nutzdaten liegen in einem Format vor, das von dieser Methode für die Zielressource nicht unterstützt wird. Dieser Antwortcode entspricht HTTP 415 „Unsupported Media Type“.
`QtCoap::ResponseCode::InternalServerFault`	`0x-60`	Auf dem Server ist ein unerwarteter Fehler aufgetreten, der die Ausführung der Anfrage verhindert hat. Dieser Antwortcode entspricht HTTP 500 „Internal Server Error“.
`QtCoap::ResponseCode::NotImplemented`	`0x-5f`	Der Server unterstützt die zur Bearbeitung der Anfrage erforderliche Funktionalität nicht. Dieser Antwortcode entspricht HTTP 501 „Not Implemented“.
`QtCoap::ResponseCode::BadGateway`	`0x-5e`	Bei einem vorgelagerten 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 kann oder will nicht als Forward-Proxy für die in der Option „Proxy-Uri“ angegebene URI oder unter Verwendung des in „Proxy-Scheme“ angegebenen Schemas fungieren.
`QtCoap::ResponseCode::InvalidCode`	`0xFF`	Ein ungültiger Antwortcode.

enum class QtCoap::SecurityMode

Gibt den Sicherheitsmodus an, der zur Sicherung einer CoAP-Verbindung gemäß der Definition in RFC 7252 verwendet wird.

Konstante	Wert	Beschreibung
`QtCoap::SecurityMode::NoSecurity`	`0`	Es gibt keine Sicherheit auf Protokollebene (DTLS ist deaktiviert).
`QtCoap::SecurityMode::PreSharedKey`	`1`	DTLS ist aktiviert. Zur Sicherung wird die PSK-Authentifizierung verwendet.
`QtCoap::SecurityMode::RawPublicKey`	`2`	DTLS ist aktiviert. Zur Sicherheit wird ein asymmetrisches Schlüsselpaar ohne Zertifikat (ein „Raw Public Key“) verwendet. Dieser Modus wird noch nicht unterstützt.
`QtCoap::SecurityMode::Certificate`	`3`	DTLS ist aktiviert. Zur Sicherheit wird ein asymmetrisches Schlüsselpaar mit einem X.509-Zertifikat verwendet.

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