Contents Index Topic Contents
	Previous Topic: CommitUrlCacheEntry Next Topic: CreateUrlCacheGroup

CreateUrlCacheEntry

BOOL CreateUrlCacheEntry(
    IN LPCSTR lpszUrlName,
    IN DWORD dwExpectedFileSize,
    IN LPCSTR lpszFileExtension,
    OUT LPSTR lpszFileName,
    IN DWORD dwReserved
);

Creates a local file name for saving the cache entry corresponding to the source name and the file extension.

• Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError.

lpszUrlName

String value that contains the name of the URL. The string should not contain any escape characters.

dwExpectedFileSize

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

String that contains an extension name of the file in the local storage.

lpszFileName

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

Reserved; must be zero.

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

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.