(Page 7 of 40 in this chapter)

vceCopyMessageText

Description

Copies the associated message text data from one voice message to another voice message.

Prototype

DWORD vceCopyMessageText ( VCEHD srcvh,
unsigned srcmsg,
VCEHD destvh,
unsigned destmsg)

srcvh Voice handle of the source VOX file.

srcmsg Source message number.

destvh Voice handle of the destination VOX file.

destmsg Destination message number.

Return Values

Events

Details

This function copies the message text for message srcmsg in the VOX file denoted by srcvh to message number destmsg in the VOX file denoted by destvh. If message text for destmsg already exists, it will be replaced.

Source and destination voice handles must belong to the same CTA context. They can be the same handle.

To copy all message text from the source file to the destination file, set the source message and the destination message to VCE_ALL_MESSAGES. This replaces all message text in the destination file.

vceCopyMessageText does not affect the current message for the CTA context.

If you want to copy message text associated with a voice message, use vceCopyMessageText. If you want to copy a voice message, use vceCopyMessage.

See Also

vceReadMessageText, vceWriteMessageText

Example


/*
 * Copy a message and its associated text from one .VOX file to another */
void myCopyPrompt (VCEHD destvh, VCEHD srcvh, unsigned message)
{
    vceCopyMessage    (srcvh, message, destvh, message);
    vceCopyMessageText(srcvh, message, destvh, message);
}

(Page 7 of 40 in this chapter)

tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.