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

Um identificador opaco usado para cancelar uma operação de cópia em andamento.

## Sintaxe

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

## Comentários

`WdCancellationHandle` é um ponteiro typedef para uma estrutura interna opaca. O chamador é responsável por gerenciar o ciclo de vida do identificador:

1. Crie um identificador chamando [WdCreateCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdcreatecancellationhandle.md).
2. Passe o identificador para [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md) por meio do parâmetro `cancellationHandle`.
3. Para cancelar a cópia em andamento, chame [WdCancelRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdcancelremotecopy.md) com o identificador a partir de um thread separado.
4. Depois que `WdRemoteCopy` retornar, feche o identificador chamando [WdCloseCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdclosecancellationhandle.md).

Um identificador pode ser duplicado usando [WdDuplicateCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdduplicatecancellationhandle.md). Cada cópia do identificador deve ser fechada de forma independente com `WdCloseCancellationHandle`.

## Requisitos

| Requisito | Valor |
| - | - |
| **Cabeçalho** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **SO com suporte** | Windows 11 e posterior |
| **Arquiteturas com suporte** | x64, ARM64 |

## Confira também

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


## Related topics

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