WdCancelRemoteCopy
Annule une opération de copie en cours.Syntaxe
Paramètres
_In_ cancellationHandleType : WdCancellationHandle Le handle d’annulation créé par WdCreateCancellationHandle et passé à WdRemoteCopy. La signalisation de ce handle entraîne l’annulation de la copie en cours.
Valeur de retour
Type : HRESULT RetourneS_OK en cas de réussite; sinon, retourne un code d’erreur.
Remarques
AppelezWdCancelRemoteCopy à partir d’un thread distinct pour annuler un appel bloquant à WdRemoteCopy. WdCancelRemoteCopy est une fonction non bloquante qui signale l’annulation; WdRemoteCopy peut retourner S_OK ou un échec.
Comme WdRemoteCopy peut retourner l’un ou l’autre résultat une fois l’annulation observée, la valeur de retour seule n’indique pas si l’opération a été annulée ou si elle s’est exécutée jusqu’à la fin. 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 lancée par l’utilisateur.