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

Функция GetUrlCacheConfigInfoA (winineti.h)

  • Статья

Извлекает сведения о конфигурации кэша.

Синтаксис

BOOL GetUrlCacheConfigInfoA(
  [in, out] LPINTERNET_CACHE_CONFIG_INFOA lpCacheConfigInfo,
            LPDWORD                       lpcbCacheConfigInfo,
  [in]      DWORD                         dwFieldControl
);

Параметры

[in, out] lpCacheConfigInfo

Указатель на INTERNET_CACHE_CONFIG_INFO структуру, которая получает сведения о конфигурации кэша. Поле dwStructSize должно быть инициализировано до размера INTERNET_CACHE_CONFIG_INFO.

lpcbCacheConfigInfo

Этот параметр зарезервирован и должен быть null.

[in] dwFieldControl

Определяет поведение функции в качестве одного из следующих значений.

Ценность Значение
CACHE_CONFIG_FORCE_CLEANUP_FC
0x00000020
 Не используется.
CACHE_CONFIG_DISK_CACHE_PATHS_FC
0x00000040
 Не используется.
CACHE_CONFIG_SYNC_MODE_FC
0x00000080
 Скрытный.
CACHE_CONFIG_CONTENT_PATHS_FC
0x00000100
 Поле CachePath структуры INTERNET_CACHE_CONFIG_INFO, указанной в параметре lpCachedConfigInfo, заполняется указателем на строку, определяющую путь к содержимому. Это нельзя использовать одновременно с CACHE_CONFIG_HISTORY_PATHS_FC или CACHE_CONFIG_COOKIES_PATHS_FC.
CACHE_CONFIG_HISTORY_PATHS_FC
0x00000400
 Поле CachePath структуры INTERNET_CACHE_CONFIG_INFO, указанной в параметре lpCachedConfigInfo, заполняется указателем на строку, определяющую путь к журналу. Это нельзя использовать одновременно с CACHE_CONFIG_CONTENT_PATHS_FC или CACHE_CONFIG_COOKIES_PATHS_FC.
CACHE_CONFIG_COOKIES_PATHS_FC
0x00000200
 Поле CachePath структуры INTERNET_CACHE_CONFIG_INFO, указанной в параметре lpCachedConfigInfo, заполняется указателем на строку, определяющую путь к файлу cookie. Это нельзя использовать одновременно с CACHE_CONFIG_CONTENT_PATHS_FC или CACHE_CONFIG_HISTORY_PATHS_FC.
CACHE_CONFIG_QUOTA_FC
0x00000800
 Поле dwQuota структуры INTERNET_CACHE_CONFIG_INFO, указанной в lpCachedConfigInfo, имеет ограничение кэша для контейнера, указанного в поле dwContainer .
CACHE_CONFIG_USER_MODE_FC
0x00001000
 Скрытный.
CACHE_CONFIG_CONTENT_USAGE_FC
0x00002000
 Поле dwNormalUsage структуры INTERNET_CACHE_CONFIG_INFO, указанной в lpCachedConfigInfo, имеет размер кэша для контейнера, указанного в поле dwContainer.
CACHE_CONFIG_STICKY_CONTENT_USAGE_FC
0x00004000
 Поле dwExemptUsage структуры INTERNET_CACHE_CONFIG_INFO, указанной в lpCachedConfigInfo, устанавливается на исключение использования, количество байтов, освобожденных от очистки, для контейнера, указанного в поле dwContainer. (Это поле должно быть контейнером содержимого.)

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

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

Замечания

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

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP, Windows 2000 Professional с пакетом обновления 4 (SP4) [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003, Windows 2000 Server с пакетом обновления 4 (SP4) [классические приложения только]
целевая платформа Виндоус
заголовка winineti.h
библиотеки Wininet.lib
DLL Wininet.dll

См. также

INTERNET_CACHE_CONFIG_INFO