共用方式為

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_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 欄位中所指定的容器。 (此欄位必須是內容容器。)

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

注意 WinINet 不支援伺服器實作。 此外，不應該從服務使用它。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

注意

winineti.h 標頭會將 GetUrlCacheConfigInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP4 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、具有 SP4 的 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winineti.h
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

INTERNET_CACHE_CONFIG_INFO