# Defining current message

When you play a message or a list of messages, the message or message list becomes the current message for pausing, resuming, and repositioning. The current message is associated with the context handle. The current message has a current position, as illustrated:

## Using current position

To... | Use...
Remove a specified number of milliseconds of data at the current position in the current message | vceErase
Start playing from the current position in the current message | vcePlay
Read data at the current position in the current message | vceRead
Start recording at the current position in the current message | vceRecord
Set the current position in the current message | vceSetPosition
Write data at the current position in the current message | vceWrite

## Using current message

To... | Use...
Copy a message from one voice object to another | vceConvertMessage
Create or replace a message in a destination object with a copy of a message in a source object | vceCopyMessage
Remove an entire message from a specified voice object | vceEraseMessage
Play a sequence of messages with no delay between messages | vcePlayList
Play one message from a specified voice object | vcePlayMessage
Copy a message from one voice object to another | vceRecordMessage
Define the current message to be a list of messages | vceSetCurrentList
Define the current message | vceSetCurrentMessage

If a voice object containing a message in the current message (list) is closed, a current message no longer exists. Play or record is stopped, if it is active.

Note: The current message is not affected when a call hangs up.