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

Identificador opaco que se usa para cancelar una operación de copia en curso.

## Sintaxis

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

## Comentarios

`WdCancellationHandle` es un puntero typedef a una estructura interna opaca. El autor de la llamada es responsable de administrar el ciclo de vida del identificador:

1. Cree un identificador llamando a [WdCreateCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdcreatecancellationhandle.md).
2. Pase el identificador a [WdRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdremotecopy.md) mediante el parámetro `cancellationHandle`.
3. Para cancelar la copia en curso, llame a [WdCancelRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdcancelremotecopy.md) con el identificador desde un subproceso independiente.
4. Cuando `WdRemoteCopy` devuelva un valor, cierre el identificador llamando a [WdCloseCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdclosecancellationhandle.md).

Un identificador se puede duplicar mediante [WdDuplicateCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdduplicatecancellationhandle.md). Cada copia del identificador debe cerrarse de forma independiente con `WdCloseCancellationHandle`.

## Requisitos

| Requisito | Valor |
| - | - |
| **Encabezado** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **Sistemas operativos compatibles** | Windows 11 y versiones posteriores |
| **Arquitecturas compatibles** | x64, ARM64 |

## Consulte también

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


## Related topics

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