✕
✕

RemoveClient

TwinCAT
Netzwerk TCP/IP Client

ns=2;s=DEPRAG Smart/Network/TCP/IP/RemoveClient

Der Befehl beendet die Verbindung eines konkreten TCP/IP-Clients und entfernt diesen aus der Liste "ActiveClients".

Parameter:

    Id
    Eindeutiger Index, mit dem der TCP/IP-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 TCP/IP-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:

    bTcpIpRemoveClient
    Eine boolesche Variable, über welche die Ausführung des RemoveClient-Befehls getriggert werden kann.
    OutputDataTcpIpRemoveClient
    Eine Instanz der ST_Int32OutputData Struktur, in welche der Rückgabewert der RemoveClient-Methode geschrieben wird.
    hrTcpIpRemoveClient
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ HRESULT.
    fbTcpIp
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_TcpIp" Funktionsbausteins.
    nDeviceId
    Eine DINT-Variable, welche die ID des zu entfernenden Clients darstellt.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
    bTcpIpRemoveClient   : BOOL;
    OutputDataTcpIpRemoveClient : ST_Int32OutputData;
    hrTcpIpRemoveClient   : HRESULT;

    fbTcpIp  : FB_TcpIp;
END_VAR

hrTcpIpRemoveClient := fbTcpIp.RemoveClient(
        bExecute   := bTcpIpRemoveClient, 
        ConnectionHandle := depragSmartConnection.ConnectionHandle, 
        nDeviceId   := 0, 
        OutputData   => OutputDataTcpIpRemoveClient);
IF hrTcpIpRemoveClient <> S_FALSE THEN 
    bTcpIpRemoveClient := 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.