✕
✕

RemoveClient

TwinCAT
Netzwerk REST Client

ns=2;s=DEPRAG Smart/Network/HTTP/REST/RemoveClient

Der Befehl beendet die Verbindung eines konkreten REST Clients und entfernt diesen aus der Liste der aktiven Clients.

Parameter:

    Id
    Eindeutiger Index, mit dem der REST Client aus der Liste "ActiveClients" abgerufen werden kann.

Rückgabewert:

    RemoveClient
    Eine Variable vom Typ OpcMethodReturnValueInt32. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eindeutiger Index, mit dem der REST Client aus der Liste "ActiveClients" abgerufen werden kann.

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bHttpRemoveClient
    Eine boolesche Variable, über welche die Ausführung des RemoveClient-Befehls getriggert werden kann.
    OutputDataHttpRemoveClient
    Eine Instanz der ST_Int32OutputData Struktur, in welche der Rückgabewert der RemoveClient-Methode geschrieben wird.
    hrHttpRemoveClient
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ HRESULT.
    fbHttpRest
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_HttpRest" Funktionsbausteins.
    ClientId
    Eine DINT-Variable, welche den zu entfernenden Client spezifiziert.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
    bHttpRemoveClient   : BOOL;
    OutputDataHttpRemoveClient : ST_Int32OutputData;
    hrHttpRemoveClient   : HRESULT;

    fbHttpRest   : FB_HttpRest;
END_VAR

hrHttpRemoveClient := fbHttpRest.RemoveClient(
         bExecute   := bHttpRemoveClient, 
         ConnectionHandle  := depragSmartConnection.ConnectionHandle,
         ClientId    := 1, 
         OutputData   => OutputDataHttpRemoveClient);
IF hrHttpRemoveClient <> S_FALSE THEN 
    bHttpRemoveClient := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.