StorageProviderHydrationPolicyModifier Enumeração

Definição

Namespace:

Windows.Storage.Provider

Fornece modificadores de política a serem usados com o StorageProviderHydrationPolicy primário.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class StorageProviderHydrationPolicyModifier

/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Storage.Provider.CloudFilesContract, 65536)]
enum class StorageProviderHydrationPolicyModifier

[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Storage.Provider.CloudFilesContract), 65536)]
public enum StorageProviderHydrationPolicyModifier

var value = Windows.Storage.Provider.StorageProviderHydrationPolicyModifier.none

Public Enum StorageProviderHydrationPolicyModifier

Herança

Enum

StorageProviderHydrationPolicyModifier

Atributos

FlagsAttribute ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows Desktop Extension SDK (introduzida na 10.0.16299.0)
API contract	Windows.Storage.Provider.CloudFilesContract (introduzida na v1.0)

Campos

AllowFullRestartHydration	8	Esse modificador de política concede à plataforma permissão para hidratar totalmente um arquivo de forma síncrona quando intercepta uma tentativa de um Filtro AV de verificar o arquivo. Os provedores de sincronização que desejam usar RestartHydration para alterar o fileSize de um Retorno de Chamada FetchData devem aceitar a política de FULL_RESTART_HYDRATION_REQUIRED ALLOW_FULL_RESTART_HYDRATION para evitar possíveis deadlocks com software antivírus e antimalware tentando verificar o arquivo e o provedor tentando alterar o fileSize usando RestartHydration.
AutoDehydrationAllowed	4	A desidratação automática de arquivo é permitida.
None	0	Nenhum modificador.
StreamingAllowed	2	Esse modificador não permite que a plataforma armazene dados no disco retornados por um provedor de sincronização.
ValidationRequired	1	Depois que os dados forem hidratados no arquivo, eles serão validados.

Comentários

ValidationRequired e StreamingAllowed são campos mutuamente exclusivos.

ValidationRequired oferece duas garantias a um provedor de sincronização. Primeiro, ele garante que os dados retornados pelo provedor de sincronização sempre sejam persistidos no disco antes de serem retornados ao aplicativo de usuário; segundo, ele permite que o provedor de sincronização recupere os mesmos dados que retornou anteriormente para a plataforma e valide sua integridade. Somente após uma confirmação bem-sucedida da integridade pelo provedor de sincronização, a plataforma concluirá a solicitação de E/S do usuário. Esse modificador ajuda a dar suporte à integridade de dados de ponta a ponta ao custo de E/S de disco extra.

StreamingAllowed concede à plataforma a permissão para não armazenar dados retornados por um provedor de sincronização em discos locais. Esse modificador de política é mutuamente exclusivo com ValidationRequired. A API falha com ERROR_INVALID_PARAMETER quando ambos os sinalizadores são especificados.

AutoDehydrationAllowed concede à plataforma a permissão para desidratar espaços reservados de arquivo de nuvem em sincronia sem a ajuda de provedores de sincronização. Sem esse sinalizador, a plataforma não tem permissão para chamar CfDehydratePlaceholder diretamente. Em vez disso, a única maneira com suporte de desidratar um espaço reservado de arquivo de nuvem é limpar o atributo fixado do arquivo e definir o atributo desafixado do arquivo e, em seguida, a desidratação real será executada de forma assíncrona pelo mecanismo de sincronização depois que ele receber a notificação de alteração de diretório nos dois atributos. Quando esse sinalizador for especificado, a plataforma poderá invocar CfDehydratePlaceholder diretamente em qualquer espaço reservado de arquivo de nuvem em sincronia. É recomendável que os provedores de sincronização ofereçam suporte à desidratação automática.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1809	17763	AutoDehydrationAllowed