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

# WdCancelRemoteCopy

> WdCancelRemoteCopy

# WdCancelRemoteCopy

Cancela uma operação de cópia em andamento.

## Sintaxe

```cpp theme={null}
HRESULT WdCancelRemoteCopy(  
         _In_ WdCancellationHandle cancellationHandle  
);  
```

### Parâmetros

`_In_ cancellationHandle`\
Tipo: **[WdCancellationHandle](/pt-BR/reference/remoting/structs/wdcancellationhandle)**

O identificador de cancelamento criado por [WdCreateCancellationHandle](/pt-BR/reference/remoting/functions/wdcreatecancellationhandle) e passado para [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy). Sinalizar esse identificador faz com que a cópia em andamento seja cancelada.

### Valor retornado

Tipo: **HRESULT**

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

## Comentários

Chame `WdCancelRemoteCopy` de um thread separado para cancelar uma chamada de bloqueio para [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy). `WdCancelRemoteCopy` é uma função sem bloqueio que sinaliza o cancelamento; `WdRemoteCopy` pode retornar `S_OK` ou uma falha.

Como `WdRemoteCopy` pode retornar qualquer um dos resultados após o cancelamento ser observado, o valor retornado sozinho não indica se a operação foi cancelada ou executada até a conclusão. Acompanhe o estado de cancelamento no seu próprio código se precisar distinguir os dois casos, por exemplo, para suprimir uma mensagem de erro ou ignorar uma nova tentativa após um cancelamento iniciado pelo usuário.

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

* [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy)
* [WdCancellationHandle](/pt-BR/reference/remoting/structs/wdcancellationhandle)
* [WdCreateCancellationHandle](/pt-BR/reference/remoting/functions/wdcreatecancellationhandle)
* [WdCloseCancellationHandle](/pt-BR/reference/remoting/functions/wdclosecancellationhandle)
* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy.md)
- [WdRemoteCopy](/ko/reference/remoting/functions/wdremotecopy.md)