IWinInetCacheHints::SetCacheExtension method

Changes the file name extension on the Microsoft Win32 Internet (WinInet) cache file to the specified extension.

Syntax

HRESULT SetCacheExtension(
  [in]      LPCWSTR pwzExt,
  [in, out] LPVOID  pszCacheFile,
  [in, out] DWORD   *pcbCacheFile,
  [in, out] DWORD   *pdwWinInetError,
  [in, out] DWORD   *pdwReserved
);

Parameters

  • pwzExt [in]
    The new file name extension. The extension must begin with a period.

  • pszCacheFile [in, out]
    A long pointer to a buffer that contains that new cache file name.

  • pcbCacheFile [in, out]
    A pointer to a DWORD that contains the size in bytes of the buffer for pszCacheFile.

  • pdwWinInetError [in, out]
    A pointer to a DWORD that contains more error information from WinInet. If no error has occurred, then this parameter is set to zero.

  • pdwReserved [in, out]
    A pointer to a DWORD that is reserved. Must be set to zero.

Return value

Returns one of the following values.

Return code Description
S_OK

Indicates success.

E_FAIL

Indicates that an unknown error has occurred.

E_INVALIDARG

Indicates that pwzExt, pszCacheFile, or pcbCacheFile is invalid.

E_OUTOFMEMORY

Indicates that an attempt to allocate memory failed.

 

Remarks

The IWinInetCacheHints::SetCacheExtension method was introduced in Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2).

Requirements

Minimum supported client

Windows XP with SP2

Minimum supported server

Windows Server 2003

Product

Internet Explorer 6.0

Header

Urlmon.h

IDL

Urlmon.idl

DLL

Urlmon.dll

See also

IWinInetCacheHints

SetCacheExtension2