M&M FDT 1.2.1 Online Specification
 IDtmDiagnosis::InitCompare() method information


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

4.3.7.2 IDtmDiagnosis::InitCompare()


This method can be called in the states:            

HRESULT InitCompare (
[in] BSTR systemTag,
[out, retval] VARIANT_BOOL* result
);


Description:
Initializes a DTM for comparison of two device instances

Parameters:
systemTagsystemTag of a second DTM of the same type


Return Value:
resultTRUE Initialization successful FALSE Initialization failed (e. g. a compare is already in progress or the DTM is not of the same type)


Behavior:
Initializes the compare of the data set owned by the DTM itself with a data set of a second device. Such a comparison is only possible within an InitCompare()ReleaseCompare() sequence. The DTM can access the second device data set by requesting the according DTM instance via IFdtTopology::GetDtmForSystemTag() with the received systemTag. To perform a comparison in the background the Compare() method can be called. Starting a compare user interface may perform a user interactive comparison. It is only possible to compare data sets handled by DTMs of the same type.

Comments:
Every comparison sequence started with InitCompare() must be closed using ReleaseCompare().




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