SetUrlCacheEntryInfo Function

---

Sets the specified members of the INTERNET_CACHE_ENTRY_INFO structure.

Syntax

BOOL SetUrlCacheEntryInfo(
    IN LPCTSTR lpszUrlName,
    IN LPINTERNET_CACHE_ENTRY_INFO lpCacheEntryInfo,
    IN DWORD dwFieldControl
);

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

Parameters

lpszUrlName

Address of a string that contains the name of the cache entry. The name string should not contain any escape characters.

lpCacheEntryInfo

Address of an INTERNET_CACHE_ENTRY_INFO structure containing the values to be assigned to the cache entry designated by lpszUrlName.

dwFieldControl

Unsigned long integer value that contains a bitmask that indicates the members that are to be set. This can be a combination of the following values:

CACHE_ENTRY_ACCTIME_FC

Sets the last access time.

CACHE_ENTRY_ATTRIBUTE_FC

Sets the cache entry type.

CACHE_ENTRY_EXEMPT_DELTA_FC

Sets the exempt delta.

CACHE_ENTRY_EXPTIME_FC

Sets the expire time.

CACHE_ENTRY_HEADERINFO_FC

Not currently implemented.

CACHE_ENTRY_HITRATE_FC

Sets the hit rate.

CACHE_ENTRY_MODTIME_FC

Sets the last modified time.

CACHE_ENTRY_SYNCTIME_FC

Sets the last sync time.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError. Possible error values include:

ERROR_FILE_NOT_FOUND	The specified cache entry is not found in the cache.
ERROR_INVALID_PARAMETER	The value(s) to be set is invalid.

Function Information

Windows NT	Use version 4.0. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0 (ANSI only), 5 (ANSI and Unicode)

Windows CE

Windows CE	Use version 2.12 and later. Implemented as ANSI and Unicode functions.
Minimum availability	Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Caching, Microsoft Win32 Internet Functions Reference, Persistent URL Cache Functions