3.17.4.1.82 Destination (Opnum 88)

  • Article

The Destination method is received by the server in an RPC_REQUEST packet. In response, the server MUST return an IDispatch interface pointer to an MSMQDestination object that represents 0 or more queues identified by the represented Message.DestinationMultiQueueFormatName.

 [propget] HRESULT Destination(
   [out, retval] IDispatch** ppdestDestination
 );

ppdestDestination: A pointer to a pointer to an IDispatch interface that upon successful completion will contain an MSMQDestination object representing the set of queues to send the message to.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

  • Create a new MSMQDestination object instance.

  • Set the QueueFormatName instance variable of the created MSMQDestination object to the value of the represented Message.DestinationMultiQueueFormatName.

  • Set the ppdestDestination output parameter to a pointer to an IDispatch4 interface for the newly created MSMQDestination object.