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

Статья
11/20/2024

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

Синтаксис

BOOL SetUrlCacheEntryInfoW(
  [in] LPCWSTR                      lpszUrlName,
  [in] LPINTERNET_CACHE_ENTRY_INFOW 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 Services (WinHTTP).

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

кэширование

функций WinINet

Поделиться через