> ## 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

Tenta cancelar uma chamada assíncrona.

## Sintaxe

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

### Parâmetros

*asyncBlock*   \_Inout\_\
Tipo: [XAsyncBlock\*](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)

Um ponteiro para o [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) da chamada assíncrona.

### Valor retornado

Tipo: void

## Comentários

Se a função `XAsyncCancel` for invocada para uma chamada assíncrona que ainda não foi concluída, as funções [XAsyncGetResult](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncgetresult.md), [XAsyncGetResultSize](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncgetresultsize.md) e [XAsyncGetStatus](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncgetstatus.md) retornarão `E_ABORT` e a conclusão da chamada assíncrona será sinalizada. O cancelamento pode ocorrer de forma síncrona, assíncrona ou simplesmente não ocorrer, dependendo da chamada que está sendo cancelada. Se um retorno de chamada de conclusão tiver sido especificado para a chamada assíncrona, ele será invocado em seguida. Para obter mais informações sobre retornos de chamada de conclusão, consulte [XAsyncCompletionRoutine](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasynccompletionroutine.md).

Se a função `XAsyncCancel` for invocada para uma chamada assíncrona que já foi concluída, nada acontecerá.

## Requisitos

**Cabeçalho:** XAsync.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Visão geral da biblioteca XAsync](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync.md)
* [Configurar a capacidade de cancelamento](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
* [Configurar um provedor personalizado](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
* [Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md)

## Confira também

[XAsyncCompletionRoutine](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasynccompletionroutine.md)\
[Membros de XAsync](https://docs.xbox.com/pt-BR/reference/system/xasync/xasync_members.md)\
[Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md)


## Related topics

- [Exemplo de configuração de cancelabilidade](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
- [Exemplo de configuração de provedor personalizado](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
- [PFMultiplayerServerPingQosServersAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversasync.md)
- [XAsync (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xasync/xasync_members.md)
- [Modo offline do Game Saves](https://docs.xbox.com/pt-BR/services/playfab/player-progression/game-saves/offline.md)