Função CommitUrlCacheEntryW (wininet.h)

Armazena dados no arquivo especificado no cache da Internet e os associa à URL especificada.

Sintaxe

BOOL CommitUrlCacheEntryW(
  [in] LPCWSTR  lpszUrlName,
  [in] LPCWSTR  lpszLocalFileName,
  [in] FILETIME ExpireTime,
  [in] FILETIME LastModifiedTime,
  [in] DWORD    CacheEntryType,
  [in] LPWSTR   lpszHeaderInfo,
  [in] DWORD    cchHeaderInfo,
  [in] LPCWSTR  lpszFileExtension,
  [in] LPCWSTR  lpszOriginalUrl
);

Parâmetros

[in] lpszUrlName

Ponteiro para uma variável de cadeia de caracteres que contém o nome de origem da entrada de cache. A cadeia de caracteres de nome deve ser exclusiva e não deve conter nenhum caractere de escape.

[in] lpszLocalFileName

Ponteiro para uma variável de cadeia de caracteres que contém o nome do arquivo local que está sendo armazenado em cache. Esse deve ser o mesmo nome que o retornado por CreateUrlCacheEntryW.

[in] ExpireTime

Estrutura FILETIME que contém a data e hora de expiração (no horário de Greenwich) do arquivo que está sendo armazenado em cache. Se a data e a hora de expiração forem desconhecidas, defina esse parâmetro como zero.

[in] LastModifiedTime

Estrutura FILETIME que contém a data e hora da última modificação (no horário de Greenwich) da URL que está sendo armazenada em cache. Se a data e a hora da última modificação forem desconhecidas, defina esse parâmetro como zero.

[in] CacheEntryType

Uma máscara de bits que indica o tipo de entrada de cache e suas propriedades. Os tipos de entrada de cache incluem: entradas de histórico (URLHISTORY_CACHE_ENTRY), entradas de cookie (COOKIE_CACHE_ENTRY) e conteúdo armazenado em cache normal (NORMAL_CACHE_ENTRY).

Esse parâmetro pode ser zero ou mais dos sinalizadores de propriedade a seguir e sinalizadores de tipo de cache listados abaixo.

[in] lpszHeaderInfo

Ponteiro para o buffer que contém as informações de cabeçalho. Se esse parâmetro não for NULL, as informações de cabeçalho serão tratadas como atributos estendidos da URL que são retornados no membro lpHeaderInfo da estrutura INTERNET_CACHE_ENTRY_INFO .

[in] cchHeaderInfo

Tamanho das informações de cabeçalho, em TCHARs. Se lpHeaderInfo não for NULL, esse valor será considerado para indicar o tamanho do buffer que armazena as informações de cabeçalho. Um aplicativo pode manter cabeçalhos como parte dos dados e fornecer cchHeaderInfo junto com um valor NULL para lpHeaderInfo.

[in] lpszFileExtension

Esse parâmetro é reservado e deve ser NULL.

[in] lpszOriginalUrl

Ponteiro para uma cadeia de caracteres que contém a URL original, se o redirecionamento tiver ocorrido.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Veja a seguir os possíveis valores de erro.

Comentários

O tipo de STICKY_CACHE_ENTRY é usado para tornar as entradas de cache isentas de limpeza. O tempo de isenção padrão para entradas definidas usando CommitUrlCacheEntryW é de dez minutos. O tempo isento pode ser alterado definindo o parâmetro de tempo expira na estrutura INTERNET_CACHE_ENTRY_INFO na chamada para a função SetUrlCacheEntryInfo .

Se o armazenamento em cache estiver cheio, CommitUrlCacheEntryW invocará a limpeza de cache para liberar espaço para esse novo arquivo. Se a entrada de cache já existir, a função substituirá a entrada se ela não estiver em uso. Uma entrada está em uso quando foi recuperada com RetrieveUrlCacheEntryStream ou RetrieveUrlCacheEntryFile.

Os clientes que adicionam entradas ao cache devem definir os cabeçalhos como pelo menos "HTTP/1.0 200 OK\r\n\r\n"; caso contrário, o Microsoft Internet Explorer e outros aplicativos cliente devem desconsiderar a entrada.

Consulte Cache , por exemplo, chamada de código CreateUrlCacheEntryW.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Requisitos

Confira também

Cache

Funções WinINet