FB_DBStoredProceduresRecordArray
Mit dem Funktionsbaustein FB_DBStoredProceduresRecordArray können gespeichert Prozeduren (Stored Procedures) aufgerufen werden, die Datensätze zurückliefern. Im Gegensatz zum FB_DBStoredProceduresRecordReturn können mit diesem Baustein auch mehrere Datensätze mit einem Aufruf zurückgeliefert werden. Sie können Parameter ü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 : POINTER TO BYTE;
bExecute : BOOL;
tTimeout : TIME := T#15s;
END_VAR sNetID: 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 Prozedur 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ätze 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 sollen.
bExecute: Mit steigender Flanke wird das Kommando ausgeführt.
tTimeout: Gibt die Zeit bis zum Abbruch 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 v3.0.0 |
PC oder CX (x86) |
Tc2_Database |