Skip to main content

WdCreateCancellationHandle

创建一个取消句柄,可用于取消由 WdRemoteCopy 启动的复制操作。

语法

参数

_Out_ cancellationHandle
类型:WdCancellationHandle*
接收新创建的取消句柄。调用方负责在不再需要时通过调用 WdCloseCancellationHandle 来释放该句柄。

返回值

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

备注

在启动复制操作之前调用 WdCreateCancellationHandle 以获取用于实现取消功能的句柄。将该句柄通过 cancellationHandle 参数传递给 WdRemoteCopy,然后从单独的线程将其传递给 WdCancelRemoteCopy 以取消操作。 WdRemoteCopy 返回后,通过调用 WdCloseCancellationHandle 关闭句柄。该句柄可在多次 WdRemoteCopy 调用之间重复使用,但每个句柄最终都必须被关闭。

要求

另请参阅

最后修改于 2026年8月24日