M&M FDT 1.2.1 Online Specification
 IFdtActiveX2::OpenChannelActiveXControlRequest() method information


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

4.9.6.4 IFdtActiveX2::OpenChannelActiveXControlRequest()


This method can be called in the states:              

HRESULT OpenChannelActiveXControlRequest (
[in] BSTR channelPath,
[in] FdtXmlDocument functionCall,
[out, retval] VARIANT_BOOL* result
);


Description:
Request to start an ActiveX functionality defined by the function call id for a certain channel object (identified by the channelPath).

Parameters:
channelPathIdentifier of the channel instance (as returned by IFdtChannel::GetChannelPath())
functionCallXML document containing the ActiveX function id for the requested user interface specified by the DTMFunctionCallSchema


Return Value:
resultTRUE The requested ActiveX control will be instantiated by the Frame Application FALSE The operation failed.


Behavior:
This method is used if the caller wants to open an ActiveX user interface which must be instantiated and embedded by the Frame Application. The Frame Application will establish the link between the new user interface and the related object via IFdtChannelActiveXControl::Init().

Comments:
The caller of this method has also to take into account the additional information (application id and operation phase) passed via the XML document. The Frame creates the Channel-ActiveX and assigns it to the channel object (referenced by channelPath) by calling IFdtChannelActiveXControl::Init().




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