UngetCommChar

2.x

  int UngetCommChar(idComDev, chUnget)    
  int idComDev; /* communications device, */  
  char chUnget; /* character to place in queue */

The UngetCommChar function places the specified character back in the receiving queue. The next read operation will return this character first.

Parameters

idComDev

Specifies the communications device that will receive the character. The OpenComm function returns this value.

chUnget

Specifies the character to be placed in the receiving queue.

Return Value

The return value is zero if the function is successful. Otherwise, it is less than zero.

Comments

Consecutive calls to the UngetCommChar function are not permitted. The character placed in the queue must be read before this function can be called again.