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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comsvcs.h

See also

IMessageMover