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

# WdCancelRemoteDelete

> Referência para WdCancelRemoteDelete, que sinaliza o cancelamento da espera do cliente por uma chamada WdDeleteRemoteFiles, com sintaxe e comentários.

# WdCancelRemoteDelete

Sinaliza o cancelamento da espera do cliente por uma operação de exclusão.

**Introduzida em:** [RIT 0.0.13-preview](/pt-BR/reference/remoting/release-versions#release-versions).

## Sintaxe

```cpp theme={null}
HRESULT WdCancelRemoteDelete(  
         _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 [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles). Sinalizar esse identificador solicita o cancelamento da espera do cliente.

### Valor retornado

Tipo: **HRESULT**

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

## Comentários

Chame `WdCancelRemoteDelete` de um thread separado para sinalizar o cancelamento de uma chamada de bloqueio para [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles). `WdCancelRemoteDelete` é uma função sem bloqueio. Se `WdDeleteRemoteFiles` observar o sinal, ela para de aguardar e retorna `S_OK` sem confirmar a conclusão no ponto de extremidade.

Como o cancelamento observado e a conclusão normal retornam `S_OK`, um chamador que pode cancelar não consegue determinar o resultado apenas pelo valor retornado. 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.

O cancelamento não interrompe a exclusão já iniciada no ponto de extremidade, que continua de forma independente. Ele não restaura itens que já foram excluídos.

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

* [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles)
* [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

- [WdCancelRemoteDelete](/reference/remoting/functions/wdcancelremotedelete.md)
- [WdDeleteRemoteFiles](/reference/remoting/functions/wddeleteremotefiles.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy.md)
- [WdCancellationHandle](/reference/remoting/structs/wdcancellationhandle.md)