Função SetUrlCacheEntryGroupA (wininet.h)

Artigo
11/20/2024

Adiciona entradas ou remove entradas de um grupo de cache.

Sintaxe

BOOL SetUrlCacheEntryGroupA(
  [in] LPCSTR  lpszUrlName,
  [in] DWORD   dwFlags,
  [in] GROUPID GroupId,
  [in] LPBYTE  pbGroupAttributes,
  [in] DWORD   cbGroupAttributes,
  [in] LPVOID  lpReserved
);

Parâmetros

[in] lpszUrlName

Ponteiro para um valor de cadeia de caracteresnulo que especifica a URL do recurso armazenado em cache.

[in] dwFlags

Determina se a entrada é adicionada ou removida de um grupo de cache. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
INTERNET_CACHE_GROUP_ADD	Adiciona a entrada de cache ao grupo de cache.
INTERNET_CACHE_GROUP_REMOVE	Remove a entrada do grupo de cache.

[in] GroupId

Identificador do grupo de cache do qual a entrada será adicionada ou removida.

[in] pbGroupAttributes

Esse parâmetro é reservado e deve ser NULL.

[in] cbGroupAttributes

Esse parâmetro é reservado e deve ser 0.

[in] lpReserved

Esse parâmetro é reservado e deve ser NULL.

Valor de retorno

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Uma entrada de cache pode pertencer a mais de um grupo de cache.

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

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

O cabeçalho wininet.h define SetUrlCacheEntryGroup como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

cache

do WinINet Functions

Compartilhar via