TransmitCommChar-Funktion (winbase.h)

Überträgt ein angegebenes Zeichen vor allen ausstehenden Daten im Ausgabepuffer des angegebenen Kommunikationsgeräts.

Syntax

BOOL TransmitCommChar(
  [in] HANDLE hFile,
  [in] char   cChar
);

Parameter

[in] hFile

Ein Handle für das Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.

[in] cChar

Das zu übertragende Zeichen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die TransmitCommChar-Funktion ist nützlich, um ein Interruptzeichen (z. B. STRG+C) an ein Hostsystem zu senden.

Wenn das Gerät nicht sendet, kann TransmitCommChar nicht wiederholt aufgerufen werden. Sobald TransmitCommChar ein Zeichen im Ausgabepuffer platziert, muss das Zeichen übertragen werden, bevor die Funktion erneut aufgerufen werden kann. Wenn das vorherige Zeichen noch nicht gesendet wurde, gibt TransmitCommChar einen Fehler zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile

WaitCommEvent