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

Crea un identificador de cancelación que se puede usar para cancelar una operación de copia iniciada por [WdRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdremotecopy.md).

## Sintaxis

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

### Parámetros

`_Out_ cancellationHandle`\
Tipo: **[WdCancellationHandle](https://docs.xbox.com/es/reference/remoting/structs/wdcancellationhandle.md)\***

Recibe el identificador de cancelación recién creado. El autor de la llamada es responsable de liberar este identificador llamando a [WdCloseCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdclosecancellationhandle.md) cuando ya no sea necesario.

### Valor devuelto

Tipo: **HRESULT**

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error.

## Comentarios

Llame a `WdCreateCancellationHandle` antes de iniciar una operación de copia para obtener un identificador que permita la cancelación. Pase el identificador a [WdRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdremotecopy.md) mediante el parámetro `cancellationHandle` y, a continuación, páselo a [WdCancelRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdcancelremotecopy.md) desde un subproceso independiente para cancelar la operación.

Cuando `WdRemoteCopy` devuelva un valor, cierre el identificador llamando a [WdCloseCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdclosecancellationhandle.md). El identificador se puede reutilizar en varias llamadas a `WdRemoteCopy`, pero cada identificador debe cerrarse en algún momento.

## Requisitos

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

## Consulte también

* [WdCloseCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdclosecancellationhandle.md)
* [WdDuplicateCancellationHandle](https://docs.xbox.com/es/reference/remoting/functions/wdduplicatecancellationhandle.md)
* [WdCancellationHandle](https://docs.xbox.com/es/reference/remoting/structs/wdcancellationhandle.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

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