enumeración CF_CONVERT_FLAGS (cfapi.h)

Marcas de conversión de archivos o directorios normales a marcador de posición o directorio.

Sintaxis

typedef enum CF_CONVERT_FLAGS {
  CF_CONVERT_FLAG_NONE = 0x00000000,
  CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
  CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
  CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
  CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
  CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;

Constantes

 
CF_CONVERT_FLAG_NONE
Valor: 0x00000000
No hay marcas de conversión.
CF_CONVERT_FLAG_MARK_IN_SYNC
Valor: 0x00000001
La plataforma marca el marcador de posición convertido como sincronizado con la nube tras una conversión correcta del archivo.
CF_CONVERT_FLAG_DEHYDRATE
Valor: 0x00000002
Solo se aplica a los archivos. Cuando se especifica, la plataforma deshidrata el archivo después de convertirlo en un marcador de posición correctamente. El autor de la llamada debe adquirir un identificador exclusivo al especificar esta marca o daños en los datos. Tenga en cuenta que la plataforma no valida la exclusividad del identificador.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Valor: 0x00000004
Solo se aplica a los directorios. Cuando se especifica, marca el directorio de marcador de posición convertido como rellenado parcialmente, de modo que cualquier acceso futuro a él dará lugar a una devolución de llamada FETCH_PLACEHOLDERS enviada al proveedor de sincronización.
CF_CONVERT_FLAG_ALWAYS_FULL
Valor: 0x00000008
Cuando esta marca esté presente, el marcador de posición recién creado se marcará como siempre lleno. Una vez hidratado, cualquier intento de deshidratar este marcador de posición (archivo) producirá un error de código de error ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. Esta marca solo se aplica en un archivo de marcador de posición. Se puede establecer en un directorio de marcador de posición, pero no tiene ningún efecto.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Valor: 0x00000010
Cuando se especifica, la plataforma permite que un motor de sincronización convierta de forma atómica un marcador de posición de archivos no en la nube (con otra etiqueta o datos de reanálisis) en un marcador de posición de archivos en la nube. Tenga en cuenta que la API normalmente produce un error en la conversión de cualquier archivo que no sea de marcador de posición en un marcador de posición.

La combinación **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
CF_CONVERT_FLAG_DEHYDRATE)** es especialmente útil en escenarios de migración cuando determinados proveedores migran desde otra plataforma a la plataforma de archivos en la nube y pretenden convertir marcadores de posición hidratados en la plataforma anterior a marcadores de posición deshidratados en la plataforma de archivos en la nube de forma atómica. Solo se debe pasar esta marca para convertir marcadores de posición completos en marcadores de posición de archivos en la nube. Si la plataforma anterior implementa archivos completos como archivos normales que no son de marcador de posición, esta marca no es necesaria. Si se pasa esta marca en un directorio, también se convierten directorios en archivos en la nube, aunque la marca DEHYDRATE no se aplica a los directorios.

Incluso cuando la directiva CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED se especificó con CfRegisterSyncRoot, solo los procesos que se han registrado o conectado a la raíz de sincronización de archivos en la nube pueden especificar esta marca.

>[! NOTA]
>La marca solo se admite si el PlatformVersion.IntegrationNumber obtenido de CfGetPlatformInfo es 0x500 o superior.

Requisitos

   
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

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo