Função UnlockUrlCacheEntryFileA (wininet.h)

  • Artigo

Desbloqueia a entrada de cache que foi bloqueada enquanto o arquivo foi recuperado para uso do cache.

Sintaxe

BOOL UnlockUrlCacheEntryFileA(
  [in] LPCSTR lpszUrlName,
  [in] DWORD  dwReserved
);

Parâmetros

[in] lpszUrlName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de origem da entrada de cache que está sendo desbloqueada. A cadeia de caracteres de nome não deve conter nenhum caractere de escape.

[in] dwReserved

Esse parâmetro é reservado e deve ser 0.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. ERROR_FILE_NOT_FOUND indica que a entrada de cache especificada pelo nome de origem não foi encontrada no armazenamento em cache.

Comentários

O aplicativo não deve acessar o arquivo depois de chamar essa função.

Quando essa função retorna, o gerenciador de cache fica livre para excluir a entrada de cache.

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

Observação

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

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