IDtm::SetCommunication() method information

M&M FDT 1.2.1 Online Specification
IDtm::SetCommunication() method information

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

4.3.1.11 IDtm::SetCommunication()

This method can be called in the states:

HRESULT SetCommunication (
[in] IFdtCommunication* communication,
[out, retval] VARIANT_BOOL* result
);

Description:

Set the interface pointer to the communication interface that the DTM has to use for online access.

Parameters:

communication

Interface pointer of a communication channel

Return Value:

result

TRUE Pointer accepted FALSE Invalid communication pointer

Behavior:

The pointer to the communication interface of a communication channel is set by the Frame Application for online calls like DownloadRequest() or UploadRequest(). The communication channel can check the supported communication protocol via IFdtChannel::GetChannelParameters() and the attribute gatewayBusCategory. In general the Frame Application is responsible to establish a valid link between a channel and a DTM or between two communication channels. This check can be done to ensure the link or in case of communication problems.

Comments:

To ensure a proper behavior, the Frame Application should implement the following rules: ' For each DTM, which acts as a root concerning the chain of interfaces for nested communication, the method IDtm::SetCommunication() must be called with a NULL pointer as parameter 'communication'. This leads to the transition from 'configured' to 'communication set' concerning the DTM state machine (refer to chapter 4.2.2, DTM State Machine) ' To set up the chain for nested communication, the Frame Application must start to hand over the interface pointer from the DTM, which acts as a root concerning the chain of interfaces for nested communication.To release the chain, according to 4.3.1.8, IDtm::PrepareToReleaseCommunication(), the Frame Application should act vice versa

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