Функция UnlockUrlCacheEntryFileW (wininet.h)

Статья
11/20/2024

Разблокирует запись кэша, заблокированную во время извлечения файла для использования из кэша.

Синтаксис

BOOL UnlockUrlCacheEntryFileW(
  [in] LPCWSTR lpszUrlName,
  [in] DWORD   dwReserved
);

Параметры

[in] lpszUrlName

Указатель на строку null-terminated, указывающую имя исходной записи кэша, которая разблокирована. Строка имени не должна содержать escape-символы.

[in] dwReserved

Этот параметр зарезервирован и должен иметь значение 0.

Возвращаемое значение

Возвращает TRUE, если выполнено успешно или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. ERROR_FILE_NOT_FOUND указывает, что запись кэша, указанная именем источника, не найдена в хранилище кэша.

Замечания

Приложение не должно получить доступ к файлу после вызова этой функции.

Когда эта функция возвращается, диспетчер кэша может удалить запись кэша.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

Заголовок wininet.h определяет UnlockUrlCacheEntryFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

кэширование

функций WinINet

Поделиться через