GetUrlCacheEntryInfoEx Function

---

Searches for the URL after translating any cached redirections that would be applied in offline mode by HttpSendRequest.

Syntax

BOOL GetUrlCacheEntryInfoEx(
    IN LPCTSTR lpszUrl,
    OUT LPINTERNET_CACHE_ENTRY_INFO lpCacheEntryInfo,
    IN OUT LPDWORD lpdwCacheEntryInfoBufSize,
    OUT LPTSTR lpszReserved,
    IN OUT LPDWORD lpdwReserved,
    LPVOID lpReserved,
    DWORD dwFlags
);

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

Parameters

lpszUrl

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 that receives information about the cache entry.

lpdwCacheEntryInfoBufSize

Address of an unsigned long integer variable that specifies the size of the lpCacheEntryInfo buffer, in TCHARs. When the function returns, the variable contains the number of TCHARs copied to the buffer, or the required size of the buffer in bytes.

lpszReserved

Reserved. Must be set to NULL.

lpdwReserved

Reserved. Must be set to NULL.

lpReserved

Reserved. Must be set to NULL.

dwFlags

Reserved. Must be set to zero.

Return Value

Returns TRUE if the URL was located, or FALSE otherwise. Call GetLastError for specific error information. Possible errors include:

ERROR_FILE_NOT_FOUND	The URL, after taking any cached redirections into account, was not found in the cache index.
ERROR_INSUFFICIENT_BUFFER	The buffer referenced by lpCacheEntryInfo was not large enough to hold the requested information. The size of the buffer needed will be returned to lpdwCacheEntryInfoBufSize.

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 4.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