PeekTouchTone method

This method will return the first touch-tone in the touch-tone queue. Since the ActiveAG touch-tone queue works in a FIFO (first in, first out) manner, this will be the earliest tone received. If there are no tones in the touch-tone queue, this method does not attempt to read any from the connected call. It simply returns immediately with a tone or without one.

If a character is read from the touch-tone queue, it is not removed from the queue and will still be available there. See the GetTouchTone method for a way to read the queue and remove the tone.

Arguments: None.

Returns: A BSTR containing a single touch-tone digit, if any are available on the queue. If none are available, then AagErrNoTone is returned.

Property interactions: None.