Database

Diese Methode erzeugt eine neue Datenbank. Optional kann angegeben werden, ob die erzeugte Datenbank auch für die Konfiguration des TwinCAT Database Servers übernommen werden soll.

Syntax

METHOD Database : BOOL
VAR_INPUT
    pDatabaseConfig: POINTER TO BYTE;
    cbDatabaseConfig: UDINT;
    bCreateXMLConfig: BOOL;
    pDBID: POINTER TO UDINT;
END_VAR

Eingänge

Name	Typ	Beschreibung
pDatabaseConfig	POINTER TO BYTE	Adresse zu der Datenbankkonfigurationsstruktur
cbDatabaseConfig	UDINT	Länge der Datenbankkonfigurationsstruktur
bCreateXMLConfig	BOOL	Gibt an, ob die neu erzeugte Datenbank als neuer Konfigurationseintrag in die XML-Datei geschrieben werden soll.
pDBID	UDINT	Gibt die hDBID zurück, wenn ein neuer Konfigurationseintrag erzeugt wurde.

Rückgabewert

Name	Typ	Beschreibung
Database	BOOL	Zeigt den Status der Methode. Liefert TRUE, sobald die Methodenausführung beendet ist, also auch im Fehlerfall.

Beispiel

VAR
    fbPLCDBCreate : FB_PLCDBCreateEvt(sNetID := '', tTimeout := T#5S);
    stConfigDB    : T_DBConfig_MsCompactSQL;
    hDBID         : UDINT;
    tcMessage     : I_TcMessage;
END_VAR

stConfigDB.bAuthentification := FALSE;
stConfigDB.sServer := 'C:\Test.sdf';

IF fbPLCDBCreate.Database(
    pDatabaseConfig:= ADR(stConfigDB),
    cbDatabaseConfig := SIZEOF(stConfigDB),
    bCreateXMLConfig := TRUE,
    pDBID := ADR(hDBID))
THEN
    IF fbPLCDBCreate.bError THEN
        tcMessage := fbPLCDBCreate.ipTcResult;
        nState := 255;
    ELSE
        nState := 0;
    END_IF
END_IF