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

Содержит сведения о заполнителях для создания новых файлов заполнителей или каталогов.

Синтаксис

typedef struct CF_PLACEHOLDER_CREATE_INFO {
  LPCWSTR                     RelativeFileName;
  CF_FS_METADATA              FsMetadata;
  LPCVOID                     FileIdentity;
  DWORD                       FileIdentityLength;
  CF_PLACEHOLDER_CREATE_FLAGS Flags;
  HRESULT                     Result;
  USN                         CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;

Члены

RelativeFileName

Имя создаваемого дочернего файла-заполнителя или каталога. Он должен состоять только из имени файла или каталога.

Например, если корень синхронизации поставщика — C:\SyncRoot, то, чтобы создать заполнитель с именем placeholder.txt в подкаталоге корня синхронизации, вызовите функцию CfCreatePlaceholders с baseDirectoryPathC:\SyncRoot\SubDirectory равным и задайте для поля RelativePathNameCF_PLACEHOLDER_CREATE_INFO значение placeholder.txt.

FsMetadata

Метаданные файловой системы, создаваемые с помощью заполнителя, включая все метки времени, атрибуты файла и размер файла (необязательно для каталогов).

FileIdentity

Буфер пользовательского режима, содержащий сведения о файлах, предоставленные поставщиком синхронизации. Размер большого двоичного объекта FileIdentity не должен превышать CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (определенный до 4 КБ). FileIdentity передается обратно поставщику синхронизации во всех обратных вызовах. Это необходимо для файлов (не для каталогов).

FileIdentityLength

Длина FileIdentity в байтах.

Flags

Флаги для указания поведения создания заполнителей. Дополнительные сведения см . в разделе CF_PLACEHOLDER_CREATE_FLAGS .

Result

Результат создания заполнителя. При успешном создании значение будет STATUS_OK.

CreateUsn

Окончательное значение USN после выполнения действий создания.

Требования

См. также раздел

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders