Discuss this help topic in MsgConnect Forum

Filter: C++  Pascal  C#  VB.NET  Java  Java ME  ActiveX  DLL 



Messenger.CreateMessageFromBinary

Messenger     See also    


Sets properties (fields) of MCMessage structure including binary data.

Declaration

[C++]
    static void CreateMessageFromBinary( long MsgCode, long Param1, long Param2, void* Binary, long BinarySize, bool IsVarData, MCMessage& Message);

[Pascal]
    class function CreateMessageFromBinary( MsgCode : integer; Param1 : integer; Param2 : integer; Binary : pointer; BinarySize : integer; IsVarData : boolean ) TMCMessage;

[VB6]
    Function IMCXMessenger4.CreateMessageFromBinary(MsgCode As Long, Param1 As Long, Param2 As Long, Binary, IsVarData As Boolean) As IMCXMessage

[ActiveX]
    HRESULT _stdcall IMCXMessenger4.CreateMessageFromBinary( [in] long MsgCode, [in] long Param1, [in] long Param2, [in] VARIANT Binary, [in] VARIANT_BOOL IsVarData, [out, retval] IMCXMessage ** Message);

[C#]
    static MCMessage CreateMessageFromBinary( int MsgCode, int Param1, int Param2, byte[] Binary, bool IsVarData );

[VB.NET]
    Public Shared Function CreateMessageFromBinary(ByVal MsgCode As Integer, ByVal Param1 As Integer, ByVal Param2 As Integer, ByVal [Binary] As Byte(), ByVal IsVarData As Boolean) As MCMessage

[Java]
    static MCMessage createMessageFromBinary( int msgCode, int param1, int param2, byte[] binary, boolean isVarData );

[Java ME]
    static MCMessage createMessageFromBinary( int msgCode, int param1, int param2, byte[] binary, boolean isVarData );

[DLL]
    void __stdcall MCMessengerCreateMessageFromBinary( long MsgCode, long Param1, long Param2, void* Binary, long BinarySize, bool IsVarData, MCMessage& Message);

Parameters

  • MsgCode - application-defined message code. Use this message code to identify the message on the recipient side.
  • Param1 - application-defined parameter of the message.
  • Param2 - application-defined parameter of the message.
  • Binary - binary data which will be copied to MCMessage.
  • BinarySize - the size of the binary data block.
  • IsVarData - false if DataType is set to bdtConst and true if DataType is set to bdtVar.
  • Message - The record that CreateMessageFromBinary creates (when Message is a function result) and filled with specified parameters. See more here

Description

    Use this method to initialize main fields including binary data of MCMessage with one call. This method copies the data referenced by Binary parameter to Data field of MCMessage.
    [C++, Pascal, Palm, DLL] After sending the message application needs to free the memory, referenced by Data field, using MCMemFree procedure.

See also:     MCMessage structure    

Discuss this help topic in MsgConnect Forum