DeleteDataSetReq

This method enables the service: DeleteDataSet. This service allows the client to delete a dynamically (at runtime) created data set instance.

METHOD DeleteDataSetReq : BOOL
VAR_INPUT
    ipDataSet : I_AcsiCommonDataSetClass;
    hUser     : PVOID;
    ipSink    : I_ScsmDeleteDataSetCnfEventSink;
END_VAR
VAR_OUTPUT
    nInvokeID : UDINT;
    ipResult  : I_AsyncServiceResultClass;
END_VAR

ipDataSet: Interface pointer of type I_AcsiCommonDataSetClass.

hUser: Optional user-defined parameter or pointer. Any value for this parameter can be transferred in the methods for service activation (XyzMethodReq). The value is then mirrored in the event handling routine for the service feedback.

ipSink: Interface pointer of type: I_ScsmDeleteDataSetCnfEventSink from an object with a user-defined implementation of the event handling routine: OnDeleteDataSetCnf (service feedback). This parameter is optional and reserved for future use. The pointer value 0 defines the parameter as optional.

nInvokeID: Identifies the service activation. Each new service activation (XyzMethodReq) is numbered consecutively. A copy of this number is mirrored in the service feedback (OnXyzMethodCnf).

ipResult: Interface pointer of type: I_AsyncServiceResultClass This pointer can be used to query and monitor the status/progress and the result of the service execution.

Return parameter: Positive feedback (TRUE) if the service primitive was sent/started successfully, negative feedback (FALSE) on error.