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 |
|
| Bibliothek |
|
| DLL |
|