enumeração CF_UPDATE_FLAGS (cfapi.h)

Sinalizadores para atualizar um arquivo ou diretório de espaço reservado.

Syntax

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

Constantes

 
CF_UPDATE_FLAG_NONE
0x00000000

Nenhum sinalizador de atualização.
CF_UPDATE_FLAG_VERIFY_IN_SYNC
0x00000001

A atualização falhará se o atributo CF_UPDATE_FLAG_MARK_IN_SYNC não estiver definido no momento no espaço reservado. Isso é para impedir que uma corrida entre a sincronização de alterações da nuvem para um espaço reservado local e o fluxo de dados do espaço reservado seja modificado localmente.
CF_UPDATE_FLAG_MARK_IN_SYNC
0x00000002

A plataforma marca o espaço reservado como em sincronia após uma operação de espaço reservado de atualização bem-sucedida.
CF_UPDATE_FLAG_DEHYDRATE
0x00000004

Aplicável somente a arquivos. Quando especificado, a plataforma desidrata o arquivo depois de atualizar o espaço reservado com êxito. O chamador deve adquirir um identificador exclusivo ao especificar esse sinalizador ou dados corrompidos podem ocorrer. Observe que a plataforma não valida a exclusividade do identificador.
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION
0x00000008

Aplicável somente a diretórios. Quando especificado, ele marca o diretório de espaço reservado atualizado 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_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION
0x00000010

Aplicável somente a diretórios. Quando especificado, ele marca o diretório de espaço reservado atualizado totalmente preenchido de modo que qualquer acesso futuro a ele seja tratado pela plataforma sem nenhum retorno de chamada para o provedor de sincronização.
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY
0x00000020

Quando especificado, FileIdentity e FileIdentityLength no CfUpdatePlaceholder são ignorados e a plataforma removerá o blob de identidade de arquivo existente no espaço reservado após uma chamada de atualização bem-sucedida.
CF_UPDATE_FLAG_CLEAR_IN_SYNC
0x00000040

A plataforma marca o espaço reservado como não sincronizado em uma operação de espaço reservado de atualização bem-sucedida.
CF_UPDATE_FLAG_REMOVE_PROPERTY
0x00000080

A plataforma remove todas as propriedades extrínsecas existentes no espaço reservado.

OBSERVAÇÃO

Esse valor está disponível em Windows 10, versão 1803 e posterior.

CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA
0x00000100

A plataforma passa CF_FS_METADATA para o sistema de arquivos sem nenhuma filtragem; caso contrário, a plataforma ignora a configuração de todos os campos cujo valor é 0.

OBSERVAÇÃO

Esse valor está disponível em Windows 10, versão 1803 e posterior.

CF_UPDATE_FLAG_ALWAYS_FULL
0x00000200

CF_UPDATE_FLAG_ALWAYS_FULL é eficaz somente em arquivos de espaço reservado. Quando especificado, o espaço reservado a ser atualizado é marcado como sempre cheio. Depois de hidratado, qualquer tentativa de desidratar esse arquivo de espaço reservado falhará com o código ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWEDde erro .
CF_UPDATE_FLAG_ALLOW_PARTIAL
0x00000400

CF_UPDATE_FLAG_ALLOW_PARTIAL é eficaz somente em arquivos de espaço reservado. Quando especificado, o estado sempre completo em um arquivo de espaço reservado, se presente, é limpo, permitindo que ele seja desidratado novamente. É inválido especificar esse sinalizador junto com CF_UPDATE_FLAG_ALWAYS_FULL e o código ERROR_CLOUD_FILE_INVALID_REQUEST de erro será retornado como resultado.

Requisitos

Requisito Valor
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

Confira também

CfUpdatePlaceholder