|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.3.16.4 IFdtEvents::OnUnlockDataSet()
| This method can be called in the states: |       |
|
HRESULT OnUnlockDataSet ( [in] BSTR systemTag, [in] BSTR userName, [out, retval] VARIANT_BOOL* result ); |
Description:
| In case of a multi-user environment, it is necessary to inform a DTM about its current access mode especially if another DTM gets the read/write access for its data set . |
Parameters:
| systemTag | Identifier of the device instance |
| userName | Human readable name of the user who has locked the data set |
Return Value:
| result | TRUE The DTM has actual data FALSE The DTM has old data and must be closed |
Behavior:
| If a DTM has unlocked a data set via IFdtContainer::UnlockDataSet() the Frame Application has to send OnUnlockDataSet() to all DTM instances which have a reference to the same data set. Receiving this notification a DTM returns TRUE if it has current data and can enable its input fields in case of an open user interface. To support this feature the DTM has to implement a synchronization mechanism for its DTM instances via OnParameterChanged(). If the DTM does not support such synchronization it has to return FALSE. That means that the DTM has old data and will not get write access for a data set. In this case of an open user interface the Frame Application will inform the user that he has to close and to restart the DTM. |
Comments:
| -/- |
© 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.