Share via


TransmitCommChar (Windows CE 5.0)

Send Feedback

This function transmits a specified character ahead of any pending data in the output buffer of the specified communications device.

BOOLTransmitCommChar(HANDLEhFile, charcChar);

Parameters

  • hFile
    [in] Handle to the communications device.

    The CreateFile function returns this handle.

  • cChar
    [in] Specifies the character to be transmitted.

Return Values

Nonzero indicates success.

Zero indicates failure.

To obtain extended error information, call the GetLastError function.

Remarks

The TransmitCommChar function is useful for sending an interrupt character (such as a CTRL+C) to a host system.

If the device is not transmitting, TransmitCommChar cannot be called repeatedly.

After TransmitCommChar places a character in the output buffer, the character must be transmitted before the function can be called again.

If the previous character has not been sent, TransmitCommChar returns an error.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winbase.h.
Link Library: Serdev.lib.

See Also

CreateFile | WaitCommEvent

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.