(Page 14 of 40 in this chapter)

vceGetCurrentSize

Description

Gets the size of the current message.

Prototype

DWORD vceGetCurrentSize ( CTAHD ctahd,
 unsigned *actualsize)

ctahd Handle returned by ctaCreateContext.

actualsize Pointer to the returned size, in milliseconds, of the current message.

Return Values

Events

Details

This function retrieves the size of the current message for the CTA context specified by ctahd. The size is in milliseconds.

If the current message is a list, this function returns the total size of all messages in the list.

Use vceGetContextInfo to get the current position in the current message.

See Also

vceGetContextInfo

Example


/* delete current message if smaller than threshold */
extern CTAHD Ctahd;

void myDeleteSmallMessage (unsigned minseconds)
{
    unsigned actualsize;      /* size in milliseconds */

    vceGetCurrentSize (Ctahd, &actualsize) ;
    if (actualsize < minseconds * 1000)
    {
        /* Use vceErase to erase the current message */
        vceSetPosition (Ctahd, 0, VCE_SEEK_SET, NULL) ;
        vceErase (Ctahd, actualsize, NULL);
    }
}

(Page 14 of 40 in this chapter)

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