IMessageMover::MoveMessages method (comsvcs.h)

Moves all messages from the source queue to the destination queue.

Syntax

HRESULT MoveMessages(
  [out] long *plMessagesMoved
);

Parameters

[out] plMessagesMoved

The number of messages that were moved from the source to the destination queue.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Messages are moved one at a time unless both the source and destination queue are transacted. In this case, CommitBatchSize specifies the number of messages that are moved before Commit is invoked. There is no provision for moving fewer than all of the messages on the queue.

Requirements

See also

IMessageMover