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

# WdDuplicateCancellationHandle

> WdDuplicateCancellationHandle

# WdDuplicateCancellationHandle

Duplica um [WdCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcancellationhandle.md) existente.

## Sintaxe

```cpp theme={null}
HRESULT WdDuplicateCancellationHandle(  
         _In_ WdCancellationHandle cancellationHandle,  
         _Out_ WdCancellationHandle* duplicatedHandle  
);  
```

### Parâmetros

`_In_ cancellationHandle`\
Tipo: **[WdCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcancellationhandle.md)**

O identificador de cancelamento a ser duplicado.

`_Out_ duplicatedHandle`\
Tipo: **[WdCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcancellationhandle.md)\***

Recebe o identificador de cancelamento duplicado. O chamador é responsável por fechar esse identificador de forma independente chamando [WdCloseCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdclosecancellationhandle.md).

### Valor retornado

Tipo: **HRESULT**

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro.

## Comentários

Use `WdDuplicateCancellationHandle` quando vários componentes precisarem referenciar o mesmo identificador de cancelamento. Tanto o identificador original quanto o duplicado se referem ao mesmo estado de cancelamento: sinalizar o cancelamento por meio de [WdCancelRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdcancelremotecopy.md) em qualquer um dos identificadores cancela a operação [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md) associada. Cada identificador deve ser fechado de forma independente com [WdCloseCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdclosecancellationhandle.md).

## 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)
* [WdCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcancellationhandle.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

- [WdCancellationHandle](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcancellationhandle.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)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/pt-BR/reference/remoting/remoteiteration_members.md)
- [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md)