FB_DBRecordSelect_EX
Mit dem Funktionsbaustein FB_DBRecordSelect_EX können einzelne Datensätze mit beliebiger Struktur aus einer Datenbank ausgelesen werden. Mit diesem Baustein können sie einen SQL SELECT Befehl mit bis zu 10000 Zeichen ausführen.
Dieser Funktionsbaustein ist nicht kompatibel mit ASCII-Files.
VAR_INPUT
VAR_INPUT
sNetID : T_AmsNetID;
hDBID : UDINT;
cbCmdSize : UDINT;
pCmdAddr : UDINT;
nRecordIndex : UDINT;
cbRecordSize : UDINT;
pDestAddr : DWORD;
bExecute : BOOL;
tTimeout : TIME;
END_VAR
sNetID : Ist ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
hDBID : Gibt die ID der zu verwendenden Datenbank an.
cbCmdSize : Gibt die länge des SELECT-Befehls an, der ausgeführt werden soll.
pCmdSize : Gibt die Pointer Adresse einer String Variablen mit dem auszuführenden SQL-Befehl an.
nRecordIndex : Gibt den Index des zu lesenden Datensatzes an.
cbRecordSize : Gibt die Größe eines Datensatzes in Byte an.
pDestAddr : Gibt die Adresse der Struktur an in die der Datensatz geschrieben werden soll.
bExecute : Mit der steigende Flanke wird das Kommando ausgeführt.
tTimeout : Gibt die Zeit bis zum Abbrechen der Funktion an.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrID : UDINT;
sSQLState : ST_DBSQLError;
nRecords : UDINT;
END_VAR
bBusy : Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE, wird kein neues Kommando angenommen.
bError : Wird TRUE, sobald ein Fehler eintritt.
nErrID : Liefert bei einem gesetzten bError-Ausgang den ADS Error Code bzw. TcDatabaseSrv_Error_Codes.
sSQLState : Liefert den SQL - Fehlercode des entsprechenden Datenbanktyps
nRecords : Liefert die Anzahl der Datensätze.
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
---|---|---|
TwinCAT v2.10.0 | PC oder CX (x86) | TcDatabase.Lib |
TwinCAT v2.10.0 | CX (ARM) |