CancelIo-Funktion

Bricht alle ausstehenden Eingabe- und Ausgabevorgänge (E/A) ab, die vom aufrufenden Thread für die angegebene Datei ausgegeben werden. Die Funktion bricht keine E/A-Vorgänge ab, die andere Threads für ein Dateihand handle ausführen.

Verwenden Sie zum Abbrechen von E/A-Vorgängen aus einem anderen Thread die CancelIoEx-Funktion.

Syntax

BOOL WINAPI CancelIo(
  _In_ HANDLE hFile
);

Parameter

hFile [ In]

Ein Handle für die Datei.

Die Funktion bricht alle ausstehenden E/A-Vorgänge für dieses Dateihand handle ab.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Der Abbrichtvorgang für alle ausstehenden E/A-Vorgänge, die vom aufrufenden Thread für das angegebene Dateihand handle ausgegeben wurden, wurde erfolgreich angefordert. Der Thread kann die GetOverlappedResult-Funktion verwenden, um zu bestimmen, wann die E/A-Vorgänge selbst abgeschlossen wurden.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Hinweise

Wenn für das angegebene Dateihand handle ausstehende E/A-Vorgänge ausgeführt werden und diese vom aufrufenden Thread ausgegeben werden, bricht die CancelIo-Funktion sie ab. CancelIo bricht nur ausstehende E/A für das Handle ab. Der Zustand des Handles wird nicht geändert. Dies bedeutet, dass Sie sich nicht auf den Status des Handle verlassen können, da Sie nicht wissen, ob der Vorgang erfolgreich abgeschlossen oder abgebrochen wurde.

Die E/A-Vorgänge müssen als überlappende E/A-Vorgänge ausgegeben werden. Falls nicht, werden die E/A-Vorgänge nicht zurückgerufen, damit der Thread die CancelIo-Funktion aufrufen kann. Das Aufrufen der CancelIo-Funktion mit einem Dateihandl, das nicht mit FILE FLAG _ _ OVERLAPPED geöffnet wird, führt nichts aus.

Alle E/A-Vorgänge, die abgebrochen werden, werden mit dem Fehler ERROR _ OPERATION _ ABORTED abgeschlossen, und alle Abschlussbenachrichtigungen für die E/A-Vorgänge treten normal auf.

In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie Unterstützt
Server Message Block (SMB) 3.0-Protokoll
Ja
SMB 3.0 Transparent Failover (TFO)
Ja
SMB 3.0 mit Dateifreigaben mit aufskalieren (SO)
Ja
Freigegebenes Clustervolume Dateisystem (CsvFS)
Ja
Robustes Dateisystem (Resilient File System, ReFS)
Ja

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [XP-Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)
Windows UWP-Apps für Server [ 2003-Desktop-Apps |]
Header
IoAPI.h (include Windows.h);
WinBase.h auf Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP (einschließlich Windows.h)
Bibliothek
Kernel32.lib
DLL
Kernel32.dll

Siehe auch

CancelIoEx

CancelSynchronousIo

CreateFile

Deviceiocontrol

Dateiverwaltungsfunktionen

LockFileEx

ReadDirectoryChangesW

ReadFile

ReadFileEx

Synchrone und asynchrone E/A

WriteFile

WriteFileEx