Skip to main content

WdCancelRemoteCopy

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

Sintaxe

Parâmetros

_In_ cancellationHandle
Tipo: WdCancellationHandle
O identificador de cancelamento criado por WdCreateCancellationHandle e passado para 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. 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

Confira também

Last modified on October 6, 2026