SendData_OnChange
Diese Methode wird einmalig aufgerufen, um Daten an den Broker zu senden.
Die SendData-Methode überträgt immer die gesamten Daten als Retain-Nachricht. Mit der SendData_OnChange-Methode hingegen ist es möglich, einzelne Teile der Daten zu übertragen, um Datenverkehr einzusparen. Es ist aber zu beachten, dass die Nachrichten mit der SendData_OnChange-Methode nicht als Retain-Nachricht geschickt werden und somit nur aktuell verbundenen App-Instanzen bekannt werden. Die Daten müssen im TwinCAT-Projekt bereitgehalten werden und bei Verbindung eines neuen Clients mithilfe der SendData-Methode als gesamter Datenblock und als Retain-Nachricht geschickt werden.
Es ist an dieser Stelle zu beachten, dass die OnChange-Mechanismen hauptsächlich für die Verwendung mit den SendDataAsString-Methoden vorgesehen sind. Mit den SendData-Methoden kann OnChange nur benutzt werden, wenn beim Senden der Struktur eine Struktur verwendet wird, die bis zu den zu ändernden Variablen den gleichen Variablenpfad an den Tag legt.
Syntax
METHOD SendData_OnChange : BOOL
VAR_INPUT
pMachineStruct : PVOID;
nStructSize : UINT;
END_VAR
Rückgabewert
Name | Typ | Beschreibung |
|---|---|---|
SendData_OnChange | BOOL | Bei erfolgreichem Aufruf liefert die Methode den Rückgabewert TRUE. |
Eingänge
Name | Typ | Beschreibung |
|---|---|---|
pMachineStruct | PVOID | Adresse zur Struktur, in der die Variablen des Gerätes deklariert werden. |
nStructSize | UINT | Größe der bei pMachineStruct angegebenen Struktur. |
Mögliche Fehler werden an den Ausgängen bError und hrErrorCode der Bausteininstanz ausgegeben.