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

# WdCreateCancellationHandle

> WdCreateCancellationHandle

# WdCreateCancellationHandle

Crée un handle d'annulation qui peut être utilisé pour annuler une opération de copie démarrée par [WdRemoteCopy](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdremotecopy.md).

## Syntaxe

```cpp theme={null}
HRESULT WdCreateCancellationHandle(  
         _Out_ WdCancellationHandle* cancellationHandle  
);  
```

### Paramètres

`_Out_ cancellationHandle`\
Type : **[WdCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/structs/wdcancellationhandle.md)\***

Reçoit le handle d'annulation nouvellement créé. L'appelant est responsable de libérer ce handle en appelant [WdCloseCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdclosecancellationhandle.md) lorsqu'il n'est plus nécessaire.

### Valeur de retour

Type : **HRESULT**

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur.

## Remarques

Appelez `WdCreateCancellationHandle` avant de démarrer une opération de copie afin d'obtenir un handle permettant l'annulation. Passez le handle à [WdRemoteCopy](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdremotecopy.md) au moyen du paramètre `cancellationHandle`, puis passez-le à [WdCancelRemoteCopy](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdcancelremotecopy.md) à partir d'un thread distinct pour annuler l'opération.

Après le retour de `WdRemoteCopy`, fermez le handle en appelant [WdCloseCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdclosecancellationhandle.md). Le handle peut être réutilisé pour plusieurs appels à `WdRemoteCopy`, mais chaque handle doit finir par être fermé.

## Configuration requise

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

## Voir aussi

* [WdCloseCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdclosecancellationhandle.md)
* [WdDuplicateCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdduplicatecancellationhandle.md)
* [WdCancellationHandle](https://docs.xbox.com/fr-CA/reference/remoting/structs/wdcancellationhandle.md)
* [WdRemoteCopy](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdremotecopy.md)
* [WdCancelRemoteCopy](https://docs.xbox.com/fr-CA/reference/remoting/functions/wdcancelremotecopy.md)
* [API d'itération à distance XBOX PC](https://docs.xbox.com/fr-CA/reference/remoting/remoteiteration_members.md)


## Related topics

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