AddReadString

Fügt ein Lese-Kommando auf einen S7 Datenpunkt vom Typ STRING zu einem Request hinzu. Der Datenpunkt wird über seine absolute Adresse in der S7 Steuerung spezifiziert. Die Länge des Strings darf 254 Zeichen nicht überschreiten.

Syntax

METHOD AddReadString    : HRESULT
VAR_INPUT
    pVar                : PVOID;
    nByteSize           : WORD;
    nByteOff            : WORD;
    nArea               : E_S7COMM_DATAAREA;
    nDatablock          : WORD;
END_VAR

Rückgabewert

Name	Datentyp	Beschreibung
AddReadString	HRESULT	E_HRESULTAdsErr.NOTINIT = Funktionsbaustein ist nicht richtig initialisiert. E_HRESULTAdsErr.BUSY = Request ist aktiv E_HRESULTAdsErr.INVALIDDATA = Ein Übergabeparameter ist falsch definiert worden E_HRESULTAdsErr.INVALIDSIZE = Die Framelänge ist größer als die PDU Länge

Name

Datentyp

Beschreibung

AddReadString

HRESULT

E_HRESULTAdsErr.NOTINIT = Funktionsbaustein ist nicht richtig initialisiert.

E_HRESULTAdsErr.BUSY = Request ist aktiv

E_HRESULTAdsErr.INVALIDDATA = Ein Übergabeparameter ist falsch definiert worden

E_HRESULTAdsErr.INVALIDSIZE = Die Framelänge ist größer als die PDU Länge

Eingänge

Name	Datentyp	Beschreibung
pVar	PVOID	Adresse der Zielvariablen in der TwinCAT SPS
nByteSize	WORD	Bytelänge des zu lesenden Datentyps aus der S7 Steuerung
nByteOff	WORD	Byte Offset in der S7 Steuerung
nArea	E_S7COMM_DATAAREA	S7 Data Area
nDatablock	WORD	ID des Datenblocks. Wird nur versendet, wenn als Data Area E_S7COMM_DATAAREA.DATA_BLOCKS verwendet wird.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64)	Tc3_S7Comm (Communication)