EldoS
MsgConnect home / Documentation / Messenger.GetMessage method
Navigation
Web site
Support
Table Of Contents

Filter: C++  Pascal  ActiveX  C#  VB.NET  Java SE  Java ME  Palm  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);

[Palm]
    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]
    If the function was called not from the same thread in which Messenger operates, MCE_WRONGTHREAD code is returned, otherwise MC_OK is 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    

 
Contact Us | Subscribe | Terms of Use | Trademarks | Privacy Statement
Copyright (c) 1998-2005, EldoS Corporation