CancelIO

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

CancelIO函数取消调用线程为指定的文件句柄发出的所有待处理的输入和输出(I / O)操作。该函数不会取消其他线程为文件句柄发出的I / O操作。

BOOL CancelIO(

HANDLE 【HFILE】//取消I / O的文件句柄
); 

参数

【HFILE】

处理文件。该函数取消该文件句柄的所有待处理I / O操作。

返回值

如果函数成功,则返回值为非零由调用线程为文件句柄发出的所有待处理I / O操作已成功取消。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

如果指定的文件句柄中有任何I / O操作正在进行,并且它们由调用线程发出,则CancelIO函数将取消它们。

请注意,I / O操作必须作为重叠I / O发出。如果没有,I / O操作将不会返回,允许线程调用CancelIO函数。使用没有使用FILE_FLAG_OVERLAPPED打开的文件句柄调用CancelIO函数什么都不做。

被取消的所有I / O操作将完成,错误ERROR_OPERATION_ABORTED。I / O操作的所有完成通知都将正常进行。

也可以看看

CreateFile, DeviceIoControl, LockFileEx, ReadDirectoryChangesW, ReadFile, ReadFileEx, WriteFile, WriteFileEx