Função FindFirstUrlCacheGroup (wininet.h)

  • Artigo

Inicia a enumeração dos grupos de cache no cache da Internet.

Sintaxe

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

Parâmetros

[in] dwFlags

Esse parâmetro é reservado e deve ser 0.

[in] dwFilter

Filtros a serem usados. Esse parâmetro pode ser zero ou um dos valores a seguir.

Valor Significado
CACHEGROUP_SEARCH_ALL
 Pesquise todos os grupos de cache.
CACHEGROUP_SEARCH_BYURL
 Não implementado atualmente.

[in] lpSearchCondition

Esse parâmetro é reservado e deve ser NULL.

[in] dwSearchCondition

Esse parâmetro é reservado e deve ser 0.

[out] lpGroupId

Ponteiro para a ID do primeiro grupo de cache que corresponde aos critérios de pesquisa.

[in, out] lpReserved

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Retorna um identificador válido para o primeiro item na enumeração se tiver êxito ou NULL caso contrário. Para obter informações de erro específicas, chame GetLastError. Se a função não encontrar arquivos correspondentes, GetLastError retornará ERROR_NO_MORE_FILES.

Comentários

O identificador retornado de FindFirstUrlCacheGroup é usado em chamadas subsequentes para FindNextUrlCacheGroup. No final da enumeração, o aplicativo deve chamar FindCloseUrlCache.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Cache

Funções WinINet