(Page 7 of 41 in this chapter) Version
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 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 context.
- To copy message text associated with a voice message, use vceCopyMessageText. 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 41 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, Natural MicroSystems, Inc. All rights
reserved.