IDtmEvents::OnOnlineStateChanged() method information

M&M FDT 1.2.1 Online Specification
IDtmEvents::OnOnlineStateChanged() method information

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

4.9.1.8 IDtmEvents::OnOnlineStateChanged()

This method can be called in the states:

HRESULT OnOnlineStateChanged (
[in] BSTR systemTag,
[in] VARIANT_BOOL onlineState
);

Description:

A DTM sends an notification about its online state.

Parameters:

systemTag	Identifier of the device instance
onlineState	TRUE means that the DTM is currently online FALSE means that the DTM is offline

Return Value:

Behavior:

If a DTM has successfully established a connection to its device it sends this notification (onlineState=TRUE) to the Frame Application so that the Frame Application can visualize the online state of the DTM. After the DTM has released the connection it sends again the notification (onlineState=FALSE) so that the Frame Application can update its view.

Comments:

The DTM is allowed to send this notification if state has not changed to inform Frame Application that it is still in the same state. This may for example happen if no connection can be established (onlineState=FALSE). The Frame Application should ignore these additional notifications.

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