Closes a voice object.

DWORD vceClose ( VCEHD vh)

vh Handle of an open voice object.

• SUCCESS
• CTAERR_INVALID_HANDLE
  vh is not a valid handle to an open voice object.

• None.

This function closes a voice file or an open memory block.

If the object is a memory block, the memory is not freed. If the object was created with vceAssignHandle, the application must close the associated file descriptor.

Note: If play or record is currently active on a message in the voice object, the play or record function is terminated. The reason in the DONE event will be CTA_REASON_STOPPED.

Refer to Section 2.2.3, Voice Handles for more information.

vceAssignHandle, vceCreateFile, vceOpenFile, vceOpenMemory

/* Close an open memory block and free the memory */

void myclosememory (VCEHD vh, BYTE *address)
{
    free (address);          /* OK to free first if not playing.*/
    vceClose (vh);
}