(Page 12 of 41 in this chapter) Version
vceEraseMessage
Description
- Deletes the specified message from a specified voice object.
Prototype
- DWORD vceEraseMessage ( VCEHD vh,
unsigned message)
- vh Handle of an open voice object.
- message Message number.
Return Values
Events
Details
- This function deletes the message in the voice object specified by vh by changing its size to zero (0). The specified message becomes the current message in the context associated with vh. The voice object must have been opened for record.
- To erase all messages in vh, specify VCE_ALL_MESSAGES as the message number.
- vceEraseMessage returns SUCCESS for any message number that is valid for the file type of vh. Otherwise, the return code is VCEERR_INVALID_MESSAGE.
See Also
- vceErase
Example
/* Replace or create a message from a data buffer */
void myWriteMessage (CTAHD ctahd, VCEHD vh, unsigned message,
char *buffer, unsigned bytes)
{
vceEraseMessage (vh, message);
vceWrite(ctahd, buffer, bytes, VCE_INSERT, NULL);
}
(Page 12 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.