структура CF_OPERATION_INFO (cfapi.h)

Статья
02/23/2024

Сведения об операции с файлом-заполнителем или папкой.

Синтаксис

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

Непрозрачный идентификатор, который однозначно идентифицирует операцию облачного файла с определенным облачным файлом.

Платформа предоставляет ConnectionKey, TransferKey и CorrelationVector для всех функций обратного вызова, зарегистрированных с помощью CfConnectSyncRoot. Кроме того, поставщики синхронизации могут получить transferKey с помощью CfGetTransferKey и CorrelationVector с помощью CfGetCorrelationVector.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1709 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Верхняя часть	cfapi.h