|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.9.8.4 IFdtContainer::UnlockDataSet()
| This method can be called in the states: |       |
|
HRESULT UnlockDataSet ( [in] BSTR systemTag, [out, retval] VARIANT_BOOL* result ); |
Description:
| Notification to the Frame Application that the DTM wants to unlock a data set and needs only read access for the currently loaded data set. |
Parameters:
| systemTag | Identifier of the device instance |
Return Value:
| result | TRUE Data set is unlocked FALSE Data set is still locked |
Behavior:
| Via this method a DTM notifies the Frame Application that it has finished the modification of the instance data set. It is up to the Frame Application to manage the notification of all dependent components, for example via IFdtEvents::OnParameterChanged() within a multi-user multi-session system. If the request fails, the DTM should notify the Frame Application via IDtmEvents:OnErrorMessage() to cause a system administrator to clean up the database. A DTM must not lock it’s instance data for its complete lifetime. Instead the DTM should try to lock data only if instance data is going to be modified and should unlock the data after the instance data is saved and no further modifications are expected. |
Comments:
| Within a single user system the method returns always TRUE. |
© by M&M Software GmbH, parts of this website taken from FDT Interface Specification Version 1.2.1, © by FDT Group, AISBL.
This website is published for support of M&M products as granted in license conditions, chapter 2.1.
Last updated 2015-02-05 15:17
Email: FDT Technical Support Line.