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
 lpCachedConfigInfo 参数中指定的INTERNET_CACHE_CONFIG_INFO结构的 CachePath 字段使用指向标识内容路径的字符串的指针填充。 这不能与 CACHE_CONFIG_HISTORY_PATHS_FC 或 CACHE_CONFIG_COOKIES_PATHS_FC 同时使用。
CACHE_CONFIG_HISTORY_PATHS_FC
0x00000400
 lpCachedConfigInfo 参数中指定的INTERNET_CACHE_CONFIG_INFO结构的 CachePath 字段使用指向标识历史记录路径的字符串的指针填充。 这不能与 CACHE_CONFIG_CONTENT_PATHS_FC 或 CACHE_CONFIG_COOKIES_PATHS_FC同时使用。
CACHE_CONFIG_COOKIES_PATHS_FC
0x00000200
 lpCachedConfigInfo 参数中指定的 INTERNET_CACHE_CONFIG_INFO 结构的 CachePath 字段使用指向标识 Cookie 路径的字符串的指针填充。 这不能与 CACHE_CONFIG_CONTENT_PATHS_FC 或 CACHE_CONFIG_HISTORY_PATHS_FC 同时使用。
CACHE_CONFIG_QUOTA_FC
0x00000800
 lpCachedConfigInfo 中指定的INTERNET_CACHE_CONFIG_INFO结构的 dwQuota 字段设置为 dwContainer 字段中指定的容器的缓存限制。
CACHE_CONFIG_USER_MODE_FC
0x00001000
 保留。
CACHE_CONFIG_CONTENT_USAGE_FC
0x00002000
 lpCachedConfigInfo 中指定的INTERNET_CACHE_CONFIG_INFO结构的 dwNormalUsage 字段设置为 dwContainer 字段中指定的容器的缓存大小。
CACHE_CONFIG_STICKY_CONTENT_USAGE_FC
0x00004000
 lpCachedConfigInfo 中指定的INTERNET_CACHE_CONFIG_INFO结构的 dwExemptUsage 字段设置为 dwContainer 字段中指定的容器的豁免使用量（从清理中免除的字节量）。 (此字段必须是内容 container.)

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。 要获得更多的错误信息，请调用 GetLastError。

注解

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

注意

winineti.h 标头将 GetUrlCacheConfigInfo 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional SP4 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003、Windows 2000 Server SP4 [仅限桌面应用]
目标平台 Windows
标头 winineti.h
Library Wininet.lib
DLL Wininet.dll

另请参阅

INTERNET_CACHE_CONFIG_INFO