3.2.5.2.10 IMessenger Interface

The IMessenger interface is implemented by the server to support distribution of user interface messages. The UUID for this interface is "081E7188-C080-4FF3-9238-29F66D6CABFD". The version for this interface is "1.0".

IMessenger inherits the IUnknown interface ([MS-DCOM] section 3.1.1.5.8). Opnums 0, 1, and 2 are IUnknown::QueryInterface, IUnknown::AddRef, and IUnknown::Release.

This interface is optional. The server MAY implement IMessenger to support message distribution.<83> As IMessenger is internal to the server, it cannot be accessed or instantiated by the client.

Methods in RPC Opnum Order

Method

Description

SendMessage

Adds a message to the send queue.

Opnum: 3

RecallMessage

Retrieves a message from the send queue.

Opnum: 4

All methods MUST NOT throw exceptions.