Função CreateUrlCacheEntryW (wininet.h)

Cria um nome de arquivo local para salvar a entrada de cache com base na URL especificada e na extensão de nome de arquivo.

Sintaxe

BOOL CreateUrlCacheEntryW(
  [in]  LPCWSTR lpszUrlName,
  [in]  DWORD   dwExpectedFileSize,
  [in]  LPCWSTR lpszFileExtension,
  [out] LPWSTR  lpszFileName,
  [in]  DWORD   dwReserved
);

Parâmetros

[in] lpszUrlName

Ponteiro para um valor de cadeia de caracteres que contém o nome da URL. A cadeia de caracteres deve conter um valor; uma cadeia de caracteres vazia fará com que CreateUrlCacheEntry falhe. Além disso, a cadeia de caracteres não deve conter nenhum caractere de escape.

[in] dwExpectedFileSize

Tamanho esperado do arquivo necessário para armazenar os dados que correspondem à entidade de origem, em TCHARs. Se o tamanho esperado for desconhecido, defina esse valor como zero.

[in] lpszFileExtension

Ponteiro para um valor de cadeia de caracteres que contém um nome de extensão do arquivo no armazenamento local.

[out] lpszFileName

Ponteiro para um buffer que recebe o nome do arquivo. O buffer deve ser grande o suficiente para armazenar o caminho do arquivo criado (pelo menos MAX_PATH caracteres de comprimento).

[in] dwReserved

Esse parâmetro é reservado e deve ser 0.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Depois que CreateUrlCacheEntry for chamado, o aplicativo poderá gravar diretamente no arquivo no armazenamento local. Quando o arquivo é recebido completamente, o chamador deve chamar CommitUrlCacheEntry para confirmar a entrada no cache.

WinINet tenta decodificar parâmetros Unicode de acordo com a página de código do sistema. Os aplicativos devem garantir que os parâmetros Unicode sejam codificados corretamente para a página de código do sistema. Os aplicativos podem definir a página de código do sistema com InternetSetOption , conforme mostrado no exemplo de código a seguir:

DWORD CP_SHIFT_JIS = 932;  // ANSI/OEM  Japanese, Shift-JIS
InternetSetOption( hRequest, 
                   INTERNET_OPTION_CODEPAGE,
                   &CP_SHIFT_JIS, 
                   sizeof(DWORD) );

Se o parâmetro Unicode não estiver codificado corretamente na página de código do sistema, WinINet tentará decodificar UTF8.

Quando os itens são recuperados do cache, a página de código do sistema usada para colocar o item no cache deve corresponder à página de código do sistema atual para o usuário. Para aplicativos em execução no IE6 e anteriores, se a decodificação da página de código do sistema falhar, a WinINet tentará decodificar UTF8.

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

Nota 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 Os Serviços HTTP do Microsoft Windows (WinHTTP).

 

Observação

O cabeçalho wininet.h define CreateUrlCacheEntry como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wininet.h
Biblioteca	Wininet.lib
DLL	Wininet.dll

Confira também

Cache

CommitUrlCacheEntry

Funções WinINet