FindFirstUrlCacheGroup

This function initiates the enumeration of the cache groups in the Internet cache.

HANDLE FindFirstUrlCacheGroup(
  DWORD dwFlags,
  DWORD dwFilter,
  LPVOID lpSearchCondition,
  DWORD dwSearchCondition,
  GROUPID* lpGroupId,
  LPVOID lpReserved
);

Parameters

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

• dwFilter
  [in] Unsigned long integer value that indicates what filters to use. The following table shows the possible values. This parameter can be one of these values.

  Value	Description
  CACHEGROUP_SEARCH_ALL	Search all of the cache groups.
  CACHEGROUP_SEARCH_BYURL	Not currently implemented.

• lpSearchCondition
  [in] Reserved. Must be set to NULL.

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

• lpGroupId
  [out] Pointer to a GROUPID variable that contains the identification of the first cache group that matches the search criteria.

• lpReserved
  [in, out] Reserved. Must be set to NULL.

Return Values

Returns a valid handle if successful, or NULL otherwise. To get specific error information, call GetLastError. If the function finds no matching files, GetLastError returns ERROR_NO_MORE_FILES.

Remarks

Pass the handle returned by this function to FindNextUrlCacheGroup to continue the enumeration by retrieving the next entry in the Internet cache. When the enumeration is complete, call FindCloseUrlCache to close the handle.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Wininet.h.
Link Library: Wininet.lib.

See Also

WinInet Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.