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

Interfaces and Methods   -   Schemas   -   FDT Specification   -   Quicklinks   -   Abbreviations
 Interface filter
 FDT 1.2
 FDT 1.2.1
 

4.9.1.3 IDtmEvents::OnErrorMessage()


This method can be called in the states:                

HRESULT OnErrorMessage (
[in] BSTR systemTag,
[in] BSTR errorMessage
);


Description:
Notification by a DTM about errors during a function call.

Parameters:
systemTagIdentifier of the device instance
errorMessageHuman readable error message


Return Value:


Behavior:
The method is necessary if the DTM works without a user interface. If a DTM works without user interface it is not allowed to display any error message within own dialog windows. It’s up to the Frame Application to handle the information. In case of errors or warnings, the human readable string can be displayed in a dialog box of the Frame Application.

Comments:
In order to give user helpful hints concerning errors, it is recommended to use this method in cases, where a function call failed and IFdtDialog::UserDialog() not be used.



Comments from fdtFAQ Forum:
Thomas Weller
created on 2006-10-23, last updated on 2006-10-23
Specification: "The method is necessary if the DTM works without a user interface." Comment: It is also necessary for DTMs with user interface. An error message displayed via this interface will typically be persistently logged by the frame application and can be reviewed by the administrator. If only a message box is used, the administrator will not be aware of problems. Specification: "If a DTM works without user interface it is not allowed to display any error message within own dialog windows." Comment: This seems only true if private dialogs are disabled (see IDtm::PrivateDialogEnabled()). In general, a DTM should use IFdtDialog::UserDialog() instead of a message box wherever possible.
Thomas Weller
created on 2006-10-27, last updated on 2006-10-27
The specification defines that OnErrorMessage() can be called in state 'existing created'. This is impossible as the DTM does not have the frame application pointer at this time.
© 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.