FB_DBStoredProceduresRecordArray
Mit dem Funktionsbaustein FB_DBStoredProceduresRecordArray können Gespeichert Prozeduren aufgerufen werden die Datensätze zurückliefert. Im Gegensatz zum FB_DBStoredProceduresRecordReturn können mit diesem Baustein auch mehrere Datensätze mit einem Aufruf zurückgeliefert werden. Sie können Parameter mit übergeben, die in den Gespeicherten Prozeduren verwendet werden.
VAR_INPUT
VAR_INPUT
sNetID : T_AmsNetID :='';
hDBID : UDINT :=1;
sProcedureName : T_MaxString :='';
cbParameterList : UDINT;
pParameterList : POINTER TO ARRAY[0..MAX_STORED_PROCEDURES_PARAMETERS] OF ST_DBParameter;
nStartIndex : UDINT;
nRecordCount : UDINT
cbRecordArraySize : UDINT;
pDesAddr : DWORD;
bExecute : BOOL;
tTimeout : TIME := T#15s;
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.
sProcedureName : Gibt den Namen der Procedure an, welche ausgeführt werden soll
cbParameterList : Gibt die Länge der Parameterliste an.
pParameterList : Enthält die Adresse der Parameterliste
nStartIndex : Gibt den Index des ersten zu lesenden Datensatzes an.
nRecordCount : Gibt die Anzahl der zu lesenden Datensätzen an.
cbRecordArraySize : Gibt die Größe des Strukturarrays in Byte an.
pDestAddr : Gibt die Adresse des Strukturarrays an in das die Datensätze 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 (Ab TcDatabaseSrv Version 1.0.17) |
TwinCAT v2.10.0 | CX (ARM) |