estructura CF_PLACEHOLDER_CREATE_INFO (cfapi.h)

Contiene información de marcador de posición para crear nuevos directorios o archivos de marcador de posición.

Sintaxis

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;

Miembros

RelativeFileName

Nombre del archivo o directorio del marcador de posición secundario que se va a crear. Solo debe constar del nombre de archivo o directorio.

Por ejemplo, si la raíz de sincronización del proveedor es C:\SyncRoot, para crear un marcador de posición denominado placeholder.txt en un subdirectorio de la raíz de sincronización, llame a la función CfCreatePlaceholders con BaseDirectoryPath igual a C:\SyncRoot\SubDirectory y establezca el campo RelativePathName del CF_PLACEHOLDER_CREATE_INFO en placeholder.txt.

FsMetadata

Metadatos del sistema de archivos que se van a crear con el marcador de posición, incluidas todas las marcas de tiempo, los atributos de archivo y el tamaño de archivo (opcional para los directorios).

FileIdentity

Un búfer de modo de usuario que contiene información de archivo proporcionada por el proveedor de sincronización. El blob FileIdentity no debe superar el tamaño de CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (definido en 4 KB). FileIdentity se devuelve al proveedor de sincronización en todas las devoluciones de llamada. Esto es necesario para los archivos (no para directorios).

FileIdentityLength

Longitud, en bytes, de FileIdentity.

Flags

Marcas para especificar el comportamiento de creación de marcadores de posición. Consulte CF_PLACEHOLDER_CREATE_FLAGS para obtener más información.

Result

Resultado de la creación del marcador de posición. Al crearse correctamente, el valor se STATUS_OK.

CreateUsn

Valor de USN final después de realizar acciones de creación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Encabezado	cfapi.h

Consulte también

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders