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

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](/reference/remoting/functions/wdcreatecancellationhandle).
2. Pase el identificador a [WdRemoteCopy](/reference/remoting/functions/wdremotecopy) mediante el parámetro `cancellationHandle`.
3. Para cancelar la copia en curso, llame a [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy) con el identificador desde un subproceso independiente.
4. Cuando `WdRemoteCopy` devuelva un valor, cierre el identificador llamando a [WdCloseCancellationHandle](/reference/remoting/functions/wdclosecancellationhandle).

Un identificador se puede duplicar mediante [WdDuplicateCancellationHandle](/reference/remoting/functions/wdduplicatecancellationhandle). 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](/reference/remoting/functions/wdcreatecancellationhandle)
* [WdCloseCancellationHandle](/reference/remoting/functions/wdclosecancellationhandle)
* [WdDuplicateCancellationHandle](/reference/remoting/functions/wdduplicatecancellationhandle)
* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy)
* [API XBOX PC Remote Iteration](/reference/remoting/remoteiteration_members)


## Related topics

- [WdDuplicateCancellationHandle](/es/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [WdCloseCancellationHandle](/es/reference/remoting/functions/wdclosecancellationhandle.md)
- [WdCreateCancellationHandle](/es/reference/remoting/functions/wdcreatecancellationhandle.md)
- [WdCancelRemoteCopy](/es/reference/remoting/functions/wdcancelremotecopy.md)
- [WdRemoteCopy](/es/reference/remoting/functions/wdremotecopy.md)