Skip to main content

WdCreateCancellationHandle

Cria um identificador de cancelamento que pode ser usado para cancelar uma operação de cópia iniciada por WdRemoteCopy.

Sintaxe

Parâmetros

_Out_ cancellationHandle
Tipo: WdCancellationHandle*
Recebe o identificador de cancelamento recém-criado. O chamador é responsável por liberar esse identificador chamando WdCloseCancellationHandle quando ele não for mais necessário.

Valor retornado

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

Comentários

Chame WdCreateCancellationHandle antes de iniciar uma operação de cópia para obter um identificador que permite o cancelamento. Passe o identificador para WdRemoteCopy por meio do parâmetro cancellationHandle e, em seguida, passe-o para WdCancelRemoteCopy de um thread separado para cancelar a operação. Depois que WdRemoteCopy retornar, feche o identificador chamando WdCloseCancellationHandle. O identificador pode ser reutilizado em várias chamadas WdRemoteCopy, mas cada identificador deve ser fechado em algum momento.

Requisitos

Confira também

Last modified on October 6, 2026