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

# XAsyncGetStatus

> XAsyncGetStatus

# XAsyncGetStatus

Retorna o status da chamada assíncrona, opcionalmente aguardando sua conclusão.

## Sintaxe

```cpp theme={null}
HRESULT XAsyncGetStatus(  
         XAsyncBlock* asyncBlock,  
         bool wait  
)  
```

### 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) que foi passado para a chamada assíncrona.

*wait*   \_In\_\
Tipo: bool

Se for true, `XAsyncGetStatus` aguardará até que a chamada assíncrona seja concluída ou cancelada.

### Valor retornado

Tipo: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retornará `S_OK` se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de erro](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

Depois que a chamada assíncrona for concluída, você poderá chamar [XAsyncGetResult](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncgetresult.md) para obter os resultados, caso a chamada assíncrona tenha um conteúdo de dados resultante. Se a chamada assíncrona não tiver um conteúdo de dados resultante, você não precisará chamar [XAsyncGetResult](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncgetresult.md).

**Observação:** tanto um retorno de chamada de conclusão quanto `XAsyncGetStatus` com o parâmetro wait definido como true podem ser usados para identificar quando uma chamada foi concluída. A ordem dessas chamadas pode ser ambígua e, como prática recomendada, você não deve usar ambos para a mesma chamada.

## Requisitos

**Cabeçalho:** XAsync.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Executar tarefa simples](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
* [Visão geral da biblioteca XAsync](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync.md)
* [Configurar 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)
* [Metas de design e melhorias da programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-whitepaper.md)

## Confira também

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


## Related topics

- [XAsyncGetResultSize](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncgetresultsize.md)
- [PFUninitializeAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfcore/functions/pfuninitializeasync.md)
- [XblAchievementsUpdateAchievementAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XAsyncCompletionRoutine](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasynccompletionroutine.md)
- [PFAuthenticationReLoginWithPSNAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithpsnasync.md)