WdCancelRemoteDelete
Signale l’annulation de l’attente du client pour une opération de suppression. Introduit dans : RIT 0.0.13-preview.Syntaxe
Paramètres
_In_ cancellationHandleType : WdCancellationHandle Handle d’annulation créé par WdCreateCancellationHandle et passé à WdDeleteRemoteFiles. La signalisation de ce handle demande l’annulation de l’attente du client.
Valeur renvoyée
Type : HRESULT RenvoieS_OK en cas de réussite ; sinon, renvoie un code d’erreur.
Remarques
AppelezWdCancelRemoteDelete depuis un thread distinct pour signaler l’annulation d’un appel bloquant à WdDeleteRemoteFiles. WdCancelRemoteDelete est une fonction non bloquante. Si WdDeleteRemoteFiles observe le signal, elle cesse d’attendre et renvoie S_OK sans confirmer l’achèvement côté point de terminaison.
Étant donné qu’une annulation observée et un achèvement normal renvoient tous deux S_OK, un appelant susceptible d’annuler ne peut pas déterminer le résultat à partir de la seule valeur renvoyée. 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.
L’annulation n’arrête pas une suppression déjà commencée sur le point de terminaison, qui se poursuit indépendamment. Elle ne restaure pas les éléments déjà supprimés.