Discuss this help topic in MsgConnect Forum

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



Messenger.GetMessage

Messenger     See also    


Returns next incoming message and removes it from the queue.

Declaration

[C++]
    void GetMessage(MCMessage* Message);

[Pascal]
    procedure GetMessage(var Message : TMCMessage);

[VB6]
    Sub GetMessage(Message As IMCXMessage)

[ActiveX]
    HRESULT _stdcall GetMessage([out] IMCXMessage ** Message);

[C#]
    public void GetMessage(ref MCMessage Message)

[VB.NET]
    Public Sub GetMessage(ByRef Message As MCMessage)

[Java]
    public void getMessage(MCMessage message);

[Java ME]
    public synchronized void getMessage(MCMessage message);

[DLL]
    long __stdcall MCMessengerGetMessage(HMCMessenger h, MCMessage* Message);

Parameters

  • [DLL]h - handle to the Messenger object that was returned by Create method

  • Message - The record that GetMessage places all message data to. See more here

Return value

[DLL]
    MC_OK is always returned.

Description

    Call this method to get the message from the input queue. This method returns only when the message is available (if the message is not available, the method doesn't return). Upon return the message is marked as being processed and the next call to GetMessage will return the next message.
    Once the message was processed, the application must call MessageProcessed method to let the Messenger send reply (if necessary) and cleanup internal records.
    This method together with PeekMessage and MessageProcessed is an alternative to using Queues.

See also:     Queue class     MCMessage structure     PeekMessage     MessageProcessed    

Discuss this help topic in MsgConnect Forum