Passer au contenu principal

WdCreateCancellationHandle

Crée un handle d’annulation qui peut être utilisé pour annuler une opération de copie démarrée par WdRemoteCopy.

Syntaxe

Paramètres

_Out_ cancellationHandle
Type : WdCancellationHandle*
Reçoit le handle d’annulation nouvellement créé. L’appelant est chargé de libérer ce handle en appelant WdCloseCancellationHandle lorsqu’il n’est plus nécessaire.

Valeur renvoyée

Type : HRESULT Renvoie S_OK en cas de réussite ; sinon, renvoie un code d’erreur.

Remarques

Appelez WdCreateCancellationHandle avant de démarrer une opération de copie afin d’obtenir un handle permettant l’annulation. Passez le handle à WdRemoteCopy via le paramètre cancellationHandle, puis passez-le à WdCancelRemoteCopy depuis un thread distinct pour annuler l’opération. Une fois que WdRemoteCopy a retourné, fermez le handle en appelant WdCloseCancellationHandle. Le handle peut être réutilisé pour plusieurs appels à WdRemoteCopy, mais chaque handle doit finalement être fermé.

Configuration requise

Voir aussi

Dernière modification le 6 octobre 2026