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

# WdCancellationHandle

> WdCancellationHandle

# WdCancellationHandle

Handle opaque utilisé pour annuler une opération de copie en cours.

## Syntaxe

```cpp theme={null}
typedef struct WdCancellationHandleImpl* WdCancellationHandle;
```

## Remarques

`WdCancellationHandle` est un pointeur défini par typedef vers une structure interne opaque. L'appelant est responsable de la gestion du cycle de vie du handle :

1. Créez un handle en appelant [WdCreateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdcreatecancellationhandle.md).
2. Passez le handle à [WdRemoteCopy](https://docs.xbox.com/fr/reference/remoting/functions/wdremotecopy.md) via le paramètre `cancellationHandle`.
3. Pour annuler la copie en cours, appelez [WdCancelRemoteCopy](https://docs.xbox.com/fr/reference/remoting/functions/wdcancelremotecopy.md) avec le handle depuis un thread distinct.
4. Après le retour de `WdRemoteCopy`, fermez le handle en appelant [WdCloseCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdclosecancellationhandle.md).

Un handle peut être dupliqué à l'aide de [WdDuplicateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdduplicatecancellationhandle.md). Chaque copie du handle doit être fermée indépendamment avec `WdCloseCancellationHandle`.

## Configuration requise

| Exigence | Valeur |
| - | - |
| **En-tête** | WdRemoteIteration.h |
| **Bibliothèque** | wdremoteapi.lib |
| **Système d'exploitation pris en charge** | Windows 11 et versions ultérieures |
| **Architectures prises en charge** | x64, ARM64 |

## Voir aussi

* [WdCreateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdcreatecancellationhandle.md)
* [WdCloseCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdclosecancellationhandle.md)
* [WdDuplicateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdduplicatecancellationhandle.md)
* [WdRemoteCopy](https://docs.xbox.com/fr/reference/remoting/functions/wdremotecopy.md)
* [WdCancelRemoteCopy](https://docs.xbox.com/fr/reference/remoting/functions/wdcancelremotecopy.md)
* [API XBOX PC Remote Iteration](https://docs.xbox.com/fr/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdDuplicateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [WdCloseCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdclosecancellationhandle.md)
- [WdCreateCancellationHandle](https://docs.xbox.com/fr/reference/remoting/functions/wdcreatecancellationhandle.md)
- [WdCancelRemoteCopy](https://docs.xbox.com/fr/reference/remoting/functions/wdcancelremotecopy.md)
- [WdCancelRemoteDelete](https://docs.xbox.com/fr/reference/remoting/functions/wdcancelremotedelete.md)