SetUrlCacheEntryInfo function

Sets the specified members of the INTERNET_CACHE_ENTRY_INFO structure.

Syntax


BOOLAPI SetUrlCacheEntryInfo(
  _In_ LPCTSTR                     lpszUrlName,
  _In_ LPINTERNET_CACHE_ENTRY_INFO lpCacheEntryInfo,
  _In_ DWORD                       dwFieldControl
);

Parameters

lpszUrlName [in]

Pointer to a null-terminated string that specifies the name of the cache entry. The name string should not contain any escape characters.

lpCacheEntryInfo [in]

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

dwFieldControl [in]

Indicates the members that are to be set. This parameter can be a combination of the following values.

Value	Meaning
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 the following.

Return code	Description
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.

Remarks

Note WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Wininet.h
Library	Wininet.lib
DLL	Wininet.dll
Unicode and ANSI names	SetUrlCacheEntryInfoW (Unicode) and SetUrlCacheEntryInfoA (ANSI)