UngetCommChar

Syntax

int UngetCommChar(nCid,cChar)

This function places the character specified by the cChar parameter back into the receive queue, making this character the first to be read on a subsequent read from the queue.

Consecutive calls to the UngetCommChar function are not allowed. The character placed back into the queue must be read before attempting to place another.

Parameter Type/Description  

nCid int Specifies the communication device to receive the character.  
cChar char Specifies the character to be placed in the receive queue.  

Return Value

The return value specifies the outcome of the function. It is zero if the function is successful. It is negative if an error occurs.