Função SetSystemFileCacheSize (memoryapi.h)

Limita o tamanho do conjunto de trabalho para o cache do sistema de arquivos.

Sintaxe

BOOL SetSystemFileCacheSize(
  [in] SIZE_T MinimumFileCacheSize,
  [in] SIZE_T MaximumFileCacheSize,
  [in] DWORD  Flags
);

Parâmetros

[in] MinimumFileCacheSize

O tamanho mínimo do cache de arquivos, em bytes. O gerenciador de memória virtual tenta manter pelo menos essa quantidade de memória residente no cache de arquivos do sistema.

Para liberar o cache, especifique (SIZE_T) -1.

[in] MaximumFileCacheSize

O tamanho máximo do cache de arquivos, em bytes. O gerenciador de memória virtual impõe esse limite somente se essa chamada ou uma chamada anterior para SetSystemFileCacheSizeespecificar FILE_CACHE_MAX_HARD_ENABLE.

Para liberar o cache, especifique (SIZE_T) -1.

[in] Flags

Os sinalizadores que habilitam ou desabilitam os limites de cache de arquivos. Se esse parâmetro for 0 (zero), os limites de tamanho manterão a configuração atual, que está desabilitada ou habilitada.

Valor	Significado
FILE_CACHE_MAX_HARD_DISABLE 0x2	Desabilite o limite de tamanho máximo. Os sinalizadores FILE_CACHE_MAX_HARD_DISABLE e FILE_CACHE_MAX_HARD_ENABLE são mutuamente exclusivos.
FILE_CACHE_MAX_HARD_ENABLE 0x1	Habilite o limite de tamanho máximo. Os sinalizadores FILE_CACHE_MAX_HARD_DISABLE e FILE_CACHE_MAX_HARD_ENABLE são mutuamente exclusivos.
FILE_CACHE_MIN_HARD_DISABLE 0x8	Desabilite o limite de tamanho mínimo. Os sinalizadores FILE_CACHE_MIN_HARD_DISABLE e FILE_CACHE_MIN_HARD_ENABLE são mutuamente exclusivos.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Habilite o limite de tamanho mínimo. Os sinalizadores FILE_CACHE_MIN_HARD_DISABLE e FILE_CACHE_MIN_HARD_ENABLE são mutuamente exclusivos.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero (0). Para obter informações de erro estendidas, chame GetLastError.

Comentários

O processo de chamada deve habilitar o privilégio SE_INCREASE_QUOTA_NAME .

Definir o parâmetro MaximumFileCacheSize como um valor muito baixo pode afetar negativamente o desempenho do sistema.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0502 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

As constantes FILE_CACHE_* serão definidas nos arquivos de cabeçalho do Windows a partir do SDK do Windows para Windows Server 2008. Se você estiver usando arquivos de cabeçalho de uma versão anterior do SDK, adicione as definições a seguir ao seu código.

#ifndef FILE_CACHE_FLAGS_DEFINED

#define FILE_CACHE_MAX_HARD_ENABLE      0x00000001
#define FILE_CACHE_MAX_HARD_DISABLE     0x00000002
#define FILE_CACHE_MIN_HARD_ENABLE      0x00000004
#define FILE_CACHE_MIN_HARD_DISABLE     0x00000008

#endif // FILE_CACHE_FLAGS_DEFINED

Requisitos

Cliente mínimo com suporte	Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	memoryapi.h (inclua Windows.h, Memoryapi.h)
Biblioteca	onecore.lib
DLL	Kernel32.dll

Confira também

GetSystemFileCacheSize

Funções de gerenciamento da memória