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

# XAsyncGetStatus

> XAsyncGetStatus

# XAsyncGetStatus

Retourne l'état de l'appel asynchrone, en attendant éventuellement qu'il se termine.

## Syntaxe

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

### Paramètres

*asyncBlock*   \_Inout\_\
Type : [XAsyncBlock\*](/fr/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) qui a été passé à l'appel asynchrone.

*wait*   \_In\_\
Type : bool

Si la valeur est true, `XAsyncGetStatus` attend que l'appel asynchrone se termine ou soit annulé.

### Valeur de retour

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

Retourne `S_OK` en cas de réussite ; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr/reference/errorcodes).

## Remarques

Une fois l'appel asynchrone terminé, vous pouvez appeler [XAsyncGetResult](/fr/reference/system/xasyncprovider/functions/xasyncgetresult) pour obtenir les résultats si l'appel asynchrone possède une charge utile de données de résultat. Si l'appel asynchrone ne possède pas de charge utile de données de résultat, vous n'avez pas besoin d'appeler [XAsyncGetResult](/fr/reference/system/xasyncprovider/functions/xasyncgetresult).

**Remarque :** un rappel d'achèvement et `XAsyncGetStatus` avec un paramètre wait défini sur true peuvent tous deux être utilisés pour déterminer quand un appel est terminé. L'ordre de ces appels peut être ambigu ; il est donc recommandé de ne pas utiliser les deux pour le même appel.

## Configuration requise

**En-tête :** XAsync.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Exécuter une tâche simple](/fr/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task)
* [Vue d'ensemble de la bibliothèque XAsync](/fr/build/core-features/common/async/async-libraries/async-library-xasync)
* [Configurer un fournisseur personnalisé](/fr/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider)
* [Modèle de programmation asynchrone](/fr/build/core-features/common/async/async-programming-model)
* [Objectifs de conception et améliorations de la programmation asynchrone](/fr/build/core-features/common/async/async-whitepaper)

## Voir aussi

[Membres XAsync](/fr/reference/system/xasync/xasync_members)\
[XAsyncGetResult](/fr/reference/system/xasyncprovider/functions/xasyncgetresult)\
[Modèle de programmation asynchrone](/fr/build/core-features/common/async/async-programming-model)


## Related topics

- [XAsyncGetStatus](/es/reference/system/xasync/functions/xasyncgetstatus.md)
- [Making Async Calls](/services/playfab/sdks/c/async.md)
- [Making async calls in the XSAPI C API](/services/xbox-services/fundamentals/xbox-services-api/live-flatc-async-patterns.md)
- [XAsyncGetResultSize](/reference/system/xasync/functions/xasyncgetresultsize.md)