WdCreateCancellationHandle
创建一个取消句柄,可用于取消由 WdRemoteCopy 启动的复制操作。语法
参数
_Out_ cancellationHandle类型:WdCancellationHandle* 接收新创建的取消句柄。调用方负责在不再需要时通过调用 WdCloseCancellationHandle 来释放该句柄。
返回值
类型:HRESULT 如果成功,则返回S_OK;否则,返回错误代码。
备注
在启动复制操作之前调用WdCreateCancellationHandle 以获取用于实现取消功能的句柄。将该句柄通过 cancellationHandle 参数传递给 WdRemoteCopy,然后从单独的线程将其传递给 WdCancelRemoteCopy 以取消操作。
在 WdRemoteCopy 返回后,通过调用 WdCloseCancellationHandle 关闭句柄。该句柄可在多次 WdRemoteCopy 调用之间重复使用,但每个句柄最终都必须被关闭。
