Skip to main content

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 responsable de libérer ce handle en appelant WdCloseCancellationHandle lorsqu’il n’est plus nécessaire.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne 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 au moyen du paramètre cancellationHandle, puis passez-le à WdCancelRemoteCopy à partir d’un thread distinct pour annuler l’opération. Après le retour de WdRemoteCopy, fermez le handle en appelant WdCloseCancellationHandle. Le handle peut être réutilisé pour plusieurs appels à WdRemoteCopy, mais chaque handle doit finir par être fermé.

Configuration requise

Voir aussi

Last modified on October 6, 2026