MsgNextBlock

Syntax

MsgNextBlock(travhandl);

travhandl

The handle used to identify this specific traversing pass. The handle is specified using the MsgOpen, MsgFrameOpen, or MsgFrameOpen function.

Description

Moves to the next block.

Returns

	Successfully moved to the next block.
	Failed to move to the next block. Possible reasons include end of Message or invalid handle.

Example

In this example, the Message contains the blocks blkA, blkB, and blkC structured as shown in the figure below.

The following Before Frame script in a PageOUT Process returns the name of the first instance of block blkB in the first instance of block blkA. Then it moves to the next block in the Message tree, and returns the name of this block (blkC):

$handle=MsgFrameOpen("blkA:1/blkB:1", 0);

$blockID1=MsgBlockId($handle);

MsgNextBlock($handle);

$blockID2=MsgBlockId($handle);