(Page 11 of 40 in this chapter)

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 CTA 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 11 of 40 in this chapter)

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