aio_cancel

aio_cancel() 試圖取消對檔案描述符 fd 未實現處理異步 I/O 請求。如果 aiocbp 是 NULL，所有的請求都被取消。否則，只有由控制塊指針 aiocbp 指定的請求被取消。對於被取消的請求普通異步通知會發生。這個請求返回狀態被設定為 -1，並且請求錯誤狀態被設定為 ECANCELED。不能被取消的請求控制塊不會改變。

頭檔案

#include <aio.h>

函式原型

int aio_cancel(int fd, struct aiocb *aiocbp);

說明

如果 aiocbp 不是 NULL，並且由 fd 指定的異步操作已經開始，結果未定義。哪種操作是可取消的由實現定義。

返回值

如果所有的請求都成功取消本函式返回 AIO_CANCELED。它返回 AIO_NOTCANCELED 則說明至少有一個請求因為正在操作而不能成功取消。此時應該通過 aio_error(3) 來檢查無效請求的狀態。本函式返回 AIO_ALLDONE 則說明在調用之前所有的操作都已經完成。當存在其它錯誤時，-1 被返回，並且 errno 被設定為合適的值。

錯誤

EBADF

fd 不是一個有效的檔案描述符。