PRJ_CANCEL_COMMAND_CB回调函数 (projectedfslib.h)

  • 项目

通知提供程序应取消以前调用回调的操作。

语法

PRJ_CANCEL_COMMAND_CB PrjCancelCommandCb;

void PrjCancelCommandCb(
  [in] const PRJ_CALLBACK_DATA *callbackData
)
{...}

parameters

[in] callbackData

有关操作的信息。 实现此回调需要以下 callbackData 成员：

CommandId 标识要取消的操作。

返回值

无

备注

提供程序回调的每个调用都有一个带有 CommandId 字段的 callbackData 参数。 如果提供程序提供此回调的实现，则它应跟踪其异步处理的回调的 CommandId 值，即它已从中返回 HRESULT_FROM_WIN32 (ERROR_IO_PENDING) 但尚未通过调用 PrjCompleteCommand 完成的回调。 如果提供程序收到此回调，则表示已取消导致调用先前回调的 I/O，要么显式取消，要么是因为在终止时发出该回调的线程。 提供程序应尽快取消处理 CommandId 标识的回调调用。

在此回调的 callbackData 中为 CommandId 调用 PrjCompleteCommand 不是错误，但它是无操作，因为导致 CommandId 标识的回调调用的 I/O 已结束。

仅在调用要取消的回调后，ProjFS 才会为给定 CommandId 调用PRJ_CANCEL_COMMAND_CB。 但是，如果将提供程序配置为允许多个并发运行的工作线程，则取消和原始调用可能会同时运行。 提供程序必须能够处理这种情况。

此回调是可选的。 如果提供程序不提供此回调的实现，则其他任何回调都不会取消。 提供程序将同步处理所有回调。

要求

   
最低受支持的客户端 Windows 10 版本 1809 [仅限桌面应用]
最低受支持的服务器 Windows Server [仅限桌面应用]
目标平台 Windows
标头 projectedfslib.h