PurgeComm-Funktion (winbase.h)

Verwirft alle Zeichen aus dem Ausgabe- oder Eingabepuffer einer angegebenen Kommunikationsressource. Außerdem können ausstehende Lese- oder Schreibvorgänge für die Ressource beendet werden.

Syntax

BOOL PurgeComm(
  [in] HANDLE hFile,
  [in] DWORD  dwFlags
);

Parameter

[in] hFile

Ein Handle für die Kommunikationsressource. Die CreateFile-Funktion gibt dieses Handle zurück.

[in] dwFlags

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

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

Wenn ein Thread PurgeComm verwendet, um einen Ausgabepuffer zu leeren, werden die gelöschten Zeichen nicht übertragen. Um den Ausgabepuffer zu leeren und gleichzeitig sicherzustellen, dass der Inhalt übertragen wird, rufen Sie die FlushFileBuffers-Funktion auf (ein synchroner Vorgang). Beachten Sie jedoch, dass FlushFileBuffers der Flusssteuerung, aber nicht dem Schreiben von Timeouts unterliegt und erst zurückgegeben wird, wenn alle ausstehenden Schreibvorgänge übertragen wurden.

Anforderungen

Siehe auch

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile