Функция SetUrlCacheEntryInfoA (wininet.h)

  • Статья

Задает указанные элементы структуры INTERNET_CACHE_ENTRY_INFO .

Синтаксис

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

Параметры

[in] lpszUrlName

Указатель на строку, завершающуюся значением NULL, которая указывает имя записи кэша. Строка имени не должна содержать escape-символов.

[in] lpCacheEntryInfo

Указатель на структуру INTERNET_CACHE_ENTRY_INFO , содержащую значения, присваиваемые записи кэша, назначенной lpszUrlName.

[in] dwFieldControl

Указывает элементы, которые необходимо задать. Этот параметр может быть сочетанием следующих значений.

Значение Значение
CACHE_ENTRY_ACCTIME_FC
 Задает время последнего доступа.
CACHE_ENTRY_ATTRIBUTE_FC
 Задает тип записи кэша.
CACHE_ENTRY_EXEMPT_DELTA_FC
 Задает разницу исключения.
CACHE_ENTRY_EXPTIME_FC
 Задает время истечения срока действия.
CACHE_ENTRY_HEADERINFO_FC
 В настоящий момент не реализовано.
CACHE_ENTRY_HITRATE_FC
 Задает частоту попаданий.
CACHE_ENTRY_MODTIME_FC
 Задает время последнего изменения.
CACHE_ENTRY_SYNCTIME_FC
 Задает время последней синхронизации.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Возможные значения ошибок:

Код возврата Описание
ERROR_FILE_NOT_FOUND
 Указанная запись кэша не найдена в кэше.
ERROR_INVALID_PARAMETER
 Недопустимые значения.

Комментарии

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Примечание

Заголовок wininet.h определяет SetUrlCacheEntryInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Кэширование

Функции WinINet