enumeração CF_CONVERT_FLAGS (cfapi.h)
Arquivo/diretório normal para sinalizadores de conversão de arquivo/diretório de espaço reservado.
Sintaxe
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_NONEValor: 0x00000000 Nenhum sinalizador de conversão. |
|
CF_CONVERT_FLAG_MARK_IN_SYNCValor: 0x00000001 A plataforma marca o espaço reservado convertido como sincronizado com a nuvem após uma conversão bem-sucedida do arquivo. |
|
CF_CONVERT_FLAG_DEHYDRATEValor: 0x00000002 Aplicável somente a arquivos. Quando especificada, a plataforma desidrata o arquivo depois de convertê-lo em um espaço reservado com êxito. O chamador deve adquirir um identificador exclusivo ao especificar esse sinalizador ou os dados corrompidos podem ocorrer. Observe que a plataforma não valida a exclusividade do identificador. |
|
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATIONValor: 0x00000004 Aplicável somente para diretórios. Quando especificado, ele marca o diretório de espaço reservado convertido como parcialmente preenchido, de modo que qualquer acesso futuro a ele resultará em um retorno de chamada FETCH_PLACEHOLDERS enviado ao provedor de sincronização. |
|
CF_CONVERT_FLAG_ALWAYS_FULLValor: 0x00000008 Quando esse sinalizador estiver presente, o espaço reservado recém-criado será marcado como sempre cheio. Depois de hidratado, qualquer tentativa de desidratar esse espaço reservado (arquivo) falhará com o código de erro ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. Esse sinalizador é imposto somente em um arquivo de espaço reservado. Ele pode ser definido em um diretório de espaço reservado, mas não tem efeito. |
|
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILEValor: 0x00000010 Quando especificada, a plataforma permite que um mecanismo de sincronização converta atomicamente um espaço reservado de arquivos que não sejam de nuvem (com outra marca/dados de nova análise) em um espaço reservado para arquivos de nuvem. Observe que a API normalmente falha na conversão de qualquer arquivo sem espaço reservado em um espaço reservado. A combinação **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE |
CF_CONVERT_FLAG_DEHYDRATE)** é especialmente útil em cenários de migração quando determinados provedores estão migrando de outra plataforma para a plataforma de arquivos de nuvem e pretendem converter espaços reservados hidratados na plataforma mais antiga para espaços reservados desidratados na plataforma de arquivos de nuvem atomicamente. Apenas esse sinalizador deve ser passado para converter espaços reservados completos em espaços reservados de arquivos de nuvem. Se a plataforma mais antiga implementar arquivos completos como arquivos regulares e não espaços reservados, esse sinalizador não será necessário. Passar esse sinalizador em um diretório também converte diretórios em arquivos de nuvem, embora o sinalizador DEHYDRATE não se aplique a diretórios. Mesmo quando a política CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED foi especificada com CfRegisterSyncRoot, somente os processos registrados/conectados à raiz de sincronização de arquivos de nuvem têm permissão para especificar esse sinalizador. >[! OBSERVAÇÃO] >O sinalizador só terá suporte se o PlatformVersion.IntegrationNumber obtido de CfGetPlatformInfo for 0x500 ou superior. |
Requisitos
| Cliente mínimo com suporte | Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Cabeçalho | cfapi.h |