CreateDataSetReq

Diese Methode aktiviert den Dienst: CreateDataSet. Mit diesem Dienst kann der Client dynamisch (zur Laufzeit) einen „persistent“ oder „non-persistent“ Datensatz (Data-Set) erstellen.

METHOD CreateDataSetReq : BOOL
VAR_INPUT
    ipDataSet     : I_AcsiCommonDataSetClass;
    ipLogicalNode : I_AcsiCommonLogicalNodeClass;
    hUser         : PVOID;
    ipSink        : I_ScsmCreateDataSetCnfEventSink;
END_VAR
VAR_OUTPUT
    nInvokeID     : UDINT;
    ipResult      : I_AsyncServiceResultClass;
END_VAR

ipDataSet: Schnittstellenzeiger vom Typ I_AcsiCommonDataSetClass.

ipLogicalNode: Schnittstellenzeiger vom Typ I_AcsiCommonLogicalNodeClass.

Der Zeiger auf den logischen Knoten bestimmt, ob ein „persistent“ oder „non-persistent“ Datensatz erstellt werden soll. Die „persistent“ Datensätze werden mit einem logischen Knoten verknüpft. In diesem Fall muss dieser Parameter gültig sein. Bei einem „non-persistent“ Datensatz hat der Parameter den Wert Null.

hUser: Optionaler benutzerdefinierter Parameter oder auch Zeiger. Ein beliebiger Wert für diesen Parameter kann in der Methoden für Dienstaktivierung (XyzMethodReq) übergeben werden. In der Ereignisbehandlungsroutine der Dienstrückmeldung wird dann der gleiche Wert gespiegelt.

ipSink: Schnittstellenzeiger vom Typ: I_ScsmCreateDataSetCnfEventSink von einem Objekt mit einer benutzerdefinierten Implementierung der Ereignisbehandlungsroutine: OnCreateDataSetCnf (Dienstrückmeldung). Dieser Parameter ist optional und für zukünftige Verwendung reserviert. Der Zeigerwert = 0 definiert den Parameter als optional.

nInvokeID: Identifiziert die Dienstaktivierung. Jede neue Dienstaktivierung (XyzMethodReq) wird fortlaufend nummeriert. Eine Kopie dieser Nummer wird in der Dienstrückmeldung gespiegelt (OnXyzMethodCnf).

ipResult: Schnittstellenzeiger vom Typ: I_AsyncServiceResultClass. Über diesen Zeiger kann der Status/Fortgang und das Resultat der Dienstausführung überwacht und abgefragt werden.

Rückgabeparameter: Positive Rückmeldung (TRUE) wenn die Dienstprimitive erfolgreich abgesetzt/gestartet wurde oder negative Rückmeldung (FALSE) beim Fehler.