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


Функция PrjClearNegativePathCache (projectedfslib.h)

Очищает кэш отрицательных путей экземпляра виртуализации, если он активен.

Синтаксис

HRESULT PrjClearNegativePathCache(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [out, optional] UINT32                               *totalEntryNumber
);

Параметры

[in] namespaceVirtualizationContext

Непрозрачный дескриптор для экземпляра виртуализации.

[out, optional] totalEntryNumber

Необязательный указатель на переменную, получающую количество путей, которые находились в кэше до его очистки.

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

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если кэш отрицательных путей активен, то, если поставщик указывает, что путь к файлу не существует, возвращая HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) из обратного вызова PRJ_GET_PLACEHOLDER_INFO_CB , ProjFS не сможет открыть этот путь после этого без повторного вызова обратного вызова PRJ_GET_PLACEHOLDER_INFO_CB . Это помогает повысить производительность экземпляров виртуализации, на которых размещаются рабочие нагрузки, которые часто проверяют наличие файла, пытаясь открыть его.

Чтобы возобновить получение PRJ_GET_PLACEHOLDER_INFO_CB обратного вызова для путей, указанных поставщиком, не существует, поставщик должен вызвать эту подпрограмму.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1809 [только классические приложения]
Минимальная версия сервера Windows Server [только классические приложения]
Целевая платформа Windows
Header projectedfslib.h