> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAsyncCancel

> XAsyncCancel

# XAsyncCancel

尝试取消一个异步调用。

## Syntax

```cpp theme={null}
void XAsyncCancel(  
         XAsyncBlock* asyncBlock  
)  
```

### Parameters

*asyncBlock*   \_Inout\_\
类型：[XAsyncBlock\*](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)

指向该异步调用的 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md) 的指针。

### Return value

类型：void

## Remarks

如果对尚未完成的异步调用调用 `XAsyncCancel` 函数，[XAsyncGetResult](https://docs.xbox.com/zh-CN/reference/system/xasyncprovider/functions/xasyncgetresult.md)、[XAsyncGetResultSize](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetresultsize.md) 和 [XAsyncGetStatus](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetstatus.md) 函数将返回 `E_ABORT`，异步调用完成会被发出信号。取消可能同步发生、异步发生或根本不发生，具体取决于要取消的调用。如果为异步调用指定了完成回调，则会调用它。有关完成回调的详细信息，请参阅 [XAsyncCompletionRoutine](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasynccompletionroutine.md)。

如果对已完成的异步调用调用 `XAsyncCancel` 函数，则不会发生任何操作。

## Requirements

**头文件：** XAsync.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [XAsync 库概述](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xasync.md)
* [设置可取消性](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
* [设置自定义提供程序](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
* [异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)

## See also

[XAsyncCompletionRoutine](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasynccompletionroutine.md)\
[XAsync Members](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.md)\
[异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)


## Related topics

- [设置可取消性示例](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
- [PFMultiplayerServerPingQosServersAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversasync.md)
- [XAsync（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.md)
- [异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)
- [Game Saves 离线模式](https://docs.xbox.com/zh-CN/services/playfab/player-progression/game-saves/offline.md)