跳转到主要内容

WdCancelRemoteDelete

为删除操作的客户端等待发出取消信号。 引入版本: RIT 0.0.13-preview。

语法

参数

_In_ cancellationHandle
类型:WdCancellationHandle
由 WdCreateCancellationHandle 创建并传递给 WdDeleteRemoteFiles 的取消句柄。发出此句柄的信号将请求取消客户端等待。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则,返回错误代码。

备注

从单独的线程调用 WdCancelRemoteDelete,可为阻塞的 WdDeleteRemoteFiles 调用发出取消信号。WdCancelRemoteDelete 是一个非阻塞函数。如果 WdDeleteRemoteFiles 观察到该信号,它将停止等待并返回 S_OK,而不确认终结点是否已完成。 由于观察到取消和正常完成都返回 S_OK,因此可能执行取消的调用方无法仅凭返回值确定结果。如果需要区分这两种情况,请在自己的代码中跟踪取消状态,例如,在用户发起取消后禁止显示错误消息或跳过重试。 取消不会停止已在终结点上开始的删除操作,该操作会独立继续进行。取消也不会还原已删除的项。

要求

另请参阅

最后修改于 2026年10月6日