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

# 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](/pt-BR/reference/remoting/functions/wdcreatecancellationhandle).
2. Passe o identificador para [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy) por meio do parâmetro `cancellationHandle`.
3. Para cancelar a cópia em andamento, chame [WdCancelRemoteCopy](/pt-BR/reference/remoting/functions/wdcancelremotecopy) com o identificador a partir de um thread separado.
4. Depois que `WdRemoteCopy` retornar, feche o identificador chamando [WdCloseCancellationHandle](/pt-BR/reference/remoting/functions/wdclosecancellationhandle).

Um identificador pode ser duplicado usando [WdDuplicateCancellationHandle](/pt-BR/reference/remoting/functions/wdduplicatecancellationhandle). 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](/pt-BR/reference/remoting/functions/wdcreatecancellationhandle)
* [WdCloseCancellationHandle](/pt-BR/reference/remoting/functions/wdclosecancellationhandle)
* [WdDuplicateCancellationHandle](/pt-BR/reference/remoting/functions/wdduplicatecancellationhandle)
* [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy)
* [WdCancelRemoteCopy](/pt-BR/reference/remoting/functions/wdcancelremotecopy)
* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [WdCancellationHandle](/reference/remoting/structs/wdcancellationhandle.md)
- [WdDuplicateCancellationHandle](/reference/remoting/functions/wdduplicatecancellationhandle.md)