Compartilhar via

Função GetUrlCacheConfigInfoW (winineti.h)

  • Artigo

Recupera informações sobre a configuração de cache.

Sintaxe

BOOL GetUrlCacheConfigInfoW(
  [in, out] LPINTERNET_CACHE_CONFIG_INFOW lpCacheConfigInfo,
            LPDWORD                       lpcbCacheConfigInfo,
  [in]      DWORD                         dwFieldControl
);

Parâmetros

[in, out] lpCacheConfigInfo

Um ponteiro para uma estrutura de INTERNET_CACHE_CONFIG_INFO que recebe informações sobre a configuração de cache. O campo dwStructSize da estrutura deve ser inicializado com o tamanho de INTERNET_CACHE_CONFIG_INFO.

lpcbCacheConfigInfo

Esse parâmetro é reservado e deve ser NULL.

[in] dwFieldControl

Determina o comportamento da função, como um dos valores a seguir.

Valor Significado
CACHE_CONFIG_FORCE_CLEANUP_FC
0x00000020
 Não usado.
CACHE_CONFIG_DISK_CACHE_PATHS_FC
0x00000040
 Não usado.
CACHE_CONFIG_SYNC_MODE_FC
0x00000080
 Reservado.
CACHE_CONFIG_CONTENT_PATHS_FC
0x00000100
 O campo cachepath da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no parâmetro lpCachedConfigInfo é preenchido com um ponteiro para uma cadeia de caracteres que identifica o caminho do conteúdo. Isso não pode ser usado ao mesmo tempo que CACHE_CONFIG_HISTORY_PATHS_FC ou CACHE_CONFIG_COOKIES_PATHS_FC.
CACHE_CONFIG_HISTORY_PATHS_FC
0x00000400
 O campo CachePath da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no parâmetro lpCachedConfigInfo é preenchido com um ponteiro para uma cadeia de caracteres que identifica o caminho do histórico. Isso não pode ser usado ao mesmo tempo que CACHE_CONFIG_CONTENT_PATHS_FC ou CACHE_CONFIG_COOKIES_PATHS_FC.
CACHE_CONFIG_COOKIES_PATHS_FC
0x00000200
 O campo cachepath da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no parâmetro lpCachedConfigInfo é preenchido com um ponteiro para uma cadeia de caracteres que identifica o caminho do cookie. Isso não pode ser usado ao mesmo tempo que CACHE_CONFIG_CONTENT_PATHS_FC ou CACHE_CONFIG_HISTORY_PATHS_FC.
CACHE_CONFIG_QUOTA_FC
0x00000800
 O campo dwQuota da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no lpCachedConfigInfo está definido como o limite de cache para o contêiner especificado no campo dwContainer .
CACHE_CONFIG_USER_MODE_FC
0x00001000
 Reservado.
CACHE_CONFIG_CONTENT_USAGE_FC
0x00002000
 O campo dwNormalUsage da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no lpCachedConfigInfo é definido como o tamanho do cache do contêiner especificado no campo dwContainer .
CACHE_CONFIG_STICKY_CONTENT_USAGE_FC
0x00004000
 O campo dwExemptUsage da estrutura de INTERNET_CACHE_CONFIG_INFO especificada no lpCachedConfigInfo é definido como o uso isento, a quantidade de bytes isentos de limpeza, para o contêiner especificado no campo dwContainer. (Esse campo deve ser o contêiner de conteúdo.)

Valor de retorno

Retorna TRUE se tiver êxito ou false caso contrário. Para obter informações de erro estendidas, chame GetLastError.

Observações

Observação WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).
 

Nota

O cabeçalho winineti.h define GetUrlCacheConfigInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP, Windows 2000 Professional com SP4 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003, Windows 2000 Server com SP4 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winineti.h
biblioteca Wininet.lib
de DLL Wininet.dll

Consulte também

INTERNET_CACHE_CONFIG_INFO