WdCancelRemoteCopy
Annule une opération de copie en cours.Syntaxe
Paramètres
_In_ cancellationHandleType : WdCancellationHandle Handle d’annulation créé par WdCreateCancellationHandle et passé à WdRemoteCopy. La signalisation de ce handle entraîne l’annulation de la copie en cours.
Valeur renvoyée
Type : HRESULT RenvoieS_OK en cas de réussite ; sinon, renvoie un code d’erreur.
Remarques
AppelezWdCancelRemoteCopy depuis un thread distinct pour annuler un appel bloquant à WdRemoteCopy. WdCancelRemoteCopy est une fonction non bloquante qui signale l’annulation ; WdRemoteCopy peut renvoyer S_OK ou un échec.
Étant donné que WdRemoteCopy peut renvoyer l’un ou l’autre résultat une fois l’annulation observée, la valeur renvoyée à elle seule n’indique pas si l’opération a été annulée ou s’est exécutée jusqu’à son terme. Suivez l’état d’annulation dans votre propre code si vous devez distinguer les deux cas, par exemple pour supprimer un message d’erreur ou ignorer une nouvelle tentative après une annulation initiée par l’utilisateur.