CreateUrlCacheEntry (Windows Embedded CE 6.0)

1/6/2010

This function creates a local file name for saving the cache entry based on the specified URL and the file extension.

Syntax

BOOL CreateUrlCacheEntry( 
  LPCTSTR lpszUrlName,
  DWORD dwExpectedFileSize, 
  LPCTSTR lpszFileExtension,
  LPTSTR lpszFileName, 
  DWORD dwReserved
);

Parameters

• lpszUrlName
  [in] Address of a string variable that contains the source name of the cache entry. The name string must be unique and should not contain any escape characters.

• dwExpectedFileSize
  [in] Unsigned long integer value that contains the expected size of the file needed to store the data corresponding to the source entity. If the expected size is unknown, set this value to zero.

• lpszFileExtension
  [in] Address of a buffer that contains information maintained in the cache database for future use.

• lpszFileName
  [out] Address of a buffer that receives the file name. The buffer should be large enough (MAX_PATH) to store the path of the created file.

• dwReserved
  [in] Reserved. Must be set to zero.

Return Value

Returns TRUE if successful, or FALSE otherwise.

Remarks

After this function is called, the application can write directly into the file in local storage. When the file is completely received, you should call CommitUrlCacheEntry to commit the entry in the cache.

Requirements

See Also

Reference

WinInet Functions
CommitUrlCacheEntry
DeleteUrlCacheEntry