Expand Minimize

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.

ValueMeaning
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 codeDescription
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

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

Unicode and ANSI names

SetUrlCacheEntryInfoW (Unicode) and SetUrlCacheEntryInfoA (ANSI)

See also

Caching
WinINet Functions

 

 

Show:
© 2014 Microsoft. All rights reserved.