GetUrlCacheConfigInfoW 函数 (winineti.h)

检索有关缓存配置的信息。

语法

BOOL GetUrlCacheConfigInfoW(
  [in, out] LPINTERNET_CACHE_CONFIG_INFOW 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_FCCACHE_CONFIG_COOKIES_PATHS_FC同时使用。
CACHE_CONFIG_HISTORY_PATHS_FC
0x00000400
lpCachedConfigInfo 参数中指定的 INTERNET_CACHE_CONFIG_INFO 结构的 CachePath 字段填充了指向标识历史记录路径的字符串的指针。 这不能与 CACHE_CONFIG_CONTENT_PATHS_FCCACHE_CONFIG_COOKIES_PATHS_FC同时使用。
CACHE_CONFIG_COOKIES_PATHS_FC
0x00000200
lpCachedConfigInfo 参数中指定的 INTERNET_CACHE_CONFIG_INFO 结构的 CachePath 字段填充了指向标识 cookie 路径的字符串的指针。 这不能与 CACHE_CONFIG_CONTENT_PATHS_FCCACHE_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 字段中指定的容器。 (此字段必须是内容容器。

返回值

如果成功,则返回 TRUE;否则返回 FALSE。 若要获取扩展的错误信息,请调用 GetLastError

言论

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

注意

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

要求

要求 价值
最低支持的客户端 具有 SP4 的 Windows XP、Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows Server 2003、带 SP4 的 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winineti.h
Wininet.lib
DLL Wininet.dll

另请参阅

INTERNET_CACHE_CONFIG_INFO