Função SetUrlCacheEntryInfoA (wininet.h)

Artigo
11/20/2024

Define os membros especificados da estrutura INTERNET_CACHE_ENTRY_INFO.

Sintaxe

BOOL SetUrlCacheEntryInfoA(
  [in] LPCSTR                       lpszUrlName,
  [in] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in] DWORD                        dwFieldControl
);

Parâmetros

[in] lpszUrlName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da entrada de cache. A cadeia de caracteres de nome não deve conter nenhum caractere de escape.

[in] lpCacheEntryInfo

Ponteiro para uma estrutura INTERNET_CACHE_ENTRY_INFO que contém os valores a serem atribuídos à entrada de cache designada por lpszUrlName.

[in] dwFieldControl

Indica os membros que devem ser definidos. Esse parâmetro pode ser uma combinação dos valores a seguir.

Valor	Significado
CACHE_ENTRY_ACCTIME_FC	Define a hora do último acesso.
CACHE_ENTRY_ATTRIBUTE_FC	Define o tipo de entrada de cache.
CACHE_ENTRY_EXEMPT_DELTA_FC	Define o delta isento.
CACHE_ENTRY_EXPTIME_FC	Define a hora de expiração.
CACHE_ENTRY_HEADERINFO_FC	Não implementado no momento.
CACHE_ENTRY_HITRATE_FC	Define a taxa de ocorrência.
CACHE_ENTRY_MODTIME_FC	Define a hora da última modificação.
CACHE_ENTRY_SYNCTIME_FC	Define a hora da última sincronização.

Valor de retorno

Retorna TRUE se bem-sucedido ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ERROR_FILE_NOT_FOUND	A entrada de cache especificada não é encontrada no cache.
ERROR_INVALID_PARAMETER	Os valores a serem definidos são inválidos.

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 wininet.h define SetUrlCacheEntryInfo 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 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

cache

do WinINet Functions

Compartilhar via