CF_OPERATION_INFO 结构 (cfapi.h)

  • 项目

有关对占位符文件或文件夹执行的操作的信息。

语法

typedef struct CF_OPERATION_INFO {
  ULONG                    StructSize;
  CF_OPERATION_TYPE        Type;
  CF_CONNECTION_KEY        ConnectionKey;
  CF_TRANSFER_KEY          TransferKey;
  const CORRELATION_VECTOR *CorrelationVector;
  const CF_SYNC_STATUS     *SyncStatus;
  CF_REQUEST_KEY           RequestKey;
} CF_OPERATION_INFO;

成员

StructSize

CF_OPERATION_INFO结构的大小。

Type

正在执行的操作的类型。 有关详细信息 ，请参阅CF_OPERATION_TYPE 。

ConnectionKey

为信道获取的连接密钥。

TransferKey

占位符的不透明句柄。

CorrelationVector

用于遥测的占位符上的相关向量。

SyncStatus

注意

此成员是 Windows 10 版本 1803 的新增成员。

平台的当前 CF_SYNC_STATUS 。

平台在对云文件占位符执行的任何失败操作时查询此信息。 如果结构可用，平台将使用提供的信息来向用户构造更有意义且可操作的消息。 平台会将此信息保留在文件上，直到该文件的最后一个句柄消失。 如果 SyncStatus 为 null，则平台将清除以前设置的同步状态（如果有）。

RequestKey

一个不透明 ID，用于唯一标识特定云文件上的云文件操作。

注解

该平台为通过 CfConnectSyncRoot 注册的所有回调函数提供 ConnectionKey、TransferKey 和 CorrelationVector。 此外，同步提供程序可以使用 CfGetTransferKey 获取 TransferKey，并使用 CfGetCorrelationVector 获取 CorrelationVector。

要求

要求 值
最低受支持的客户端 Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
标头 cfapi.h

另请参阅

CF_OPERATION_TYPE

CfConnectSyncRoot

CfGetTransferKey

CfGetCorrelationVector

CfExecute

CF_SYNC_STATUS