GetUrlCacheConfigInfoW function (winineti.h)
Retrieves information about cache configuration.
Syntax
BOOL GetUrlCacheConfigInfoW(
[in, out] LPINTERNET_CACHE_CONFIG_INFOW lpCacheConfigInfo,
LPDWORD lpcbCacheConfigInfo,
[in] DWORD dwFieldControl
);
Parameters
[in, out] lpCacheConfigInfo
A pointer to an INTERNET_CACHE_CONFIG_INFO structure that receives information about the cache configuration. The dwStructSize field of the structure should be initialized to the size of INTERNET_CACHE_CONFIG_INFO.
lpcbCacheConfigInfo
This parameter is reserved and must be NULL.
[in] dwFieldControl
Determines the behavior of the function, as one of the following values.
Value | Meaning |
---|---|
|
Not used. |
|
Not used. |
|
Reserved. |
|
The CachePath field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo parameter is filled with a pointer to a string identifying the content path. This cannot be used at the same time as CACHE_CONFIG_HISTORY_PATHS_FC or CACHE_CONFIG_COOKIES_PATHS_FC. |
|
The CachePath field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo parameter is filled with a pointer to a string identifying the history path. This cannot be used at the same time as CACHE_CONFIG_CONTENT_PATHS_FC or CACHE_CONFIG_COOKIES_PATHS_FC. |
|
The CachePath field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo parameter is filled with a pointer to a string identifying the cookie path. This cannot be used at the same time as CACHE_CONFIG_CONTENT_PATHS_FC or CACHE_CONFIG_HISTORY_PATHS_FC. |
|
The dwQuota field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo is set to the cache limit for the container specified in the dwContainer field. |
|
Reserved. |
|
The dwNormalUsage field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo is set to the cache size for the container specified in the dwContainer field. |
|
The dwExemptUsage field of the INTERNET_CACHE_CONFIG_INFO structure specified in the lpCachedConfigInfo is set to the exempt usage, the amount of bytes exempt from scavenging, for the container specified in the dwContainer field. (This field must be the content container.) |
Return value
Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError.
Remarks
Note
The winineti.h header defines GetUrlCacheConfigInfo as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP, Windows 2000 Professional with SP4 [desktop apps only] |
Minimum supported server | Windows Server 2003, Windows 2000 Server with SP4 [desktop apps only] |
Target Platform | Windows |
Header | winineti.h |
Library | Wininet.lib |
DLL | Wininet.dll |