TsgcWSPClient_MQTTMethoden › Disconnect

Disconnect Methode

Sendet ein MQTT-DISCONNECT-Paket, um die Sitzung sauber zu beenden.

Überladungen

Overload 1

Syntax

procedure Disconnect;

Hinweise

Führt eine standardmäßige MQTT-Trennung mit Reason-Code 0 (Normal Disconnection) und ohne zusätzliche Eigenschaften durch. Verwenden Sie diese Überladung, wenn die Anwendung sich einfach abmelden und die Zustellung der Last-Will-Nachricht unterdrücken möchte. Der zugrunde liegende WebSocket-Transport wird hier nicht geschlossen; rufen Sie Disconnect des übergeordneten Clients auf, um den Socket abzubauen.

Beispiel

MQTT.Disconnect;

Überladung 2

Syntax

procedure Disconnect(aReasonCode: Integer; aDisconnectProperties: TsgcWSMQTTDisconnect_Properties = nil);

Parameter

NameTypBeschreibung
aReasonCodeIntegerMQTT 5.0-Reason-Code, der an den Broker gemeldet wird (zum Beispiel 0 = Normal, 4 = Disconnect with Will Message, 129 = Malformed Packet, 139 = Server Shutting Down).
aDisconnectPropertiesTsgcWSMQTTDisconnect_PropertiesOptionale MQTT-5.0-Eigenschaften wie Session Expiry Interval, Reason String, Server Reference oder User Properties. Übergeben Sie nil, wenn keine Eigenschaften erforderlich sind.

Hinweise

MQTT-5.0-Überladung, die es dem Client ermöglicht, zu signalisieren, warum er die Verbindung verlässt. Das Setzen von aReasonCode auf 4 fordert den Broker auf, das konfigurierte Last Will Testament zu veröffentlichen, während jeder Code ungleich null den Broker veranlasst, das abnormale Schließen zu protokollieren. Wird ignoriert, wenn die Sitzung als MQTT 3.1.1 ausgehandelt wurde.

Beispiel

oProps := TsgcWSMQTTDisconnect_Properties.Create;
try
  oProps.ReasonString := 'client shutting down';
  MQTT.Disconnect(0, oProps);
finally
  oProps.Free;
end;

Zurück zu Methoden