M&M FDT 1.2.1 Online Specification
 IFdtEvents::OnLockDataSet() method information


Interfaces and Methods   -   Schemas   -   FDT Specification   -   Quicklinks   -   Abbreviations

4.3.16.2 IFdtEvents::OnLockDataSet()


This method can be called in the states:              

HRESULT OnLockDataSet (
[in] BSTR systemTag,
[in] BSTR userName
);


Description:
In case of a multi-user environment, it is necessary to inform the DTM about its current access mode especially if another DTM gets the read/write access for its data set .

Parameters:
systemTagIdentifier of the device instance
userNameHuman readable name of the user who has locked the data set


Return Value:


Behavior:
If a DTM has locked a data set via IFdtContainer::LockDataSet() the Frame Application has to send OnLockDataSet() to all DTM instances which have a reference to the same data set. Receiving this notification a DTM should disable its input fields in case of an open user interface and keep in mind that it is not allowed to perform any function which needs any data storage.

Comments:
The userName can be the login name of a user or an identifier within a user management of a Frame Application. At least the userName should provide the information where to find the other user within a multi-user environment.




© 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.