Anwenderschnittstellen (API)
7.6 API IInstances
Tabelle 7- 150
Syntax
Parameter
Rückgabewerte
170
ReadByte() - Native C++
ERuntimeErrorCode ReadBytes(
EArea in_Area,
UINT32 in_Offset,
UINT32 in_BytesToRead,
UINT32* out_BytesRead,
BYTE inout_Values[]
);
•
EArea in_Area:
Die Area, von der Sie lesen möchten. Zulässige Werte:
{SRA_INPUT, SRA_MARKER, SRA_OUTPUT}.
:
•
UINT32 in_Offset
Der Byte-Offset innerhalb der Area. Der Wert muss zwischen 0 und dem Wert
sein, der von
GetAreaSize()
•
UINT32 in_BytesToRead:
Enthält die Größe des Wertespeichers.
•
UINT32* out_BytesRead:
Enthält die Anzahl der Bytes, die gerade in den Wertespeicher geschrieben
wurden.
•
BYTE inout_Values[]:
Der Speicher für die Bytes, die aus der Area gelesen werden.
Runtime Fehlercode
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_INDEX_OUT_OF_RANGE
SREC_WRONG_ARGUMENT
Siehe EArea (Seite 358).
zurückgegeben wird.
Bedingung
Die Funktion ist erfolgreich.
Die Instanz ist im Runtime Manager nicht
registriert.
Die Funktion kehrt nicht rechtzeitig wie-
der.
Der Prozess des virtuellen Controllers
läuft nicht.
Der Offset liegt außerhalb der Area-
Größe. Kein Byte konnte gelesen wer-
den.
Die Area ist ungültig.
Funktionshandbuch, 12/2017, A5E37039506-AB
S7-PLCSIM Advanced