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

Статья
02/01/2024

Настраивает экземпляр виртуализации ProjFS и запускает его, делая его доступным для операций ввода-вывода службы и вызывая обратные вызовы в поставщике.

Синтаксис

HRESULT PrjStartVirtualizing(
  [in]           PCWSTR                               virtualizationRootPath,
  [in]           const PRJ_CALLBACKS                  *callbacks,
  [in, optional] const void                           *instanceContext,
  [in, optional] const PRJ_STARTVIRTUALIZING_OPTIONS  *options,
  [out]          PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT *namespaceVirtualizationContext
);

Параметры

[in] virtualizationRootPath

Указатель на строку Юникода, завершающуюся null, задающую полный путь к корневому каталогу виртуализации.

Поставщик должен вызвать PrjMarkDirectoryAsPlaceholder , передав указанный путь в качестве параметра rootPathName и NULL в качестве параметра targetPathName перед вызовом этой процедуры. Это необходимо сделать только один раз, чтобы назначить путь в качестве корневого каталога виртуализации.

[in] callbacks

Указатель на структуру PRJ_CALLBACKS , заполненную указателями на функции обратного вызова поставщика.

[in, optional] instanceContext

Указатель на контекстную информацию, определяемую поставщиком для каждого экземпляра. Этот параметр является необязательным и может иметь значение NULL. Если он указан, ProjFS вернет его в элементе InstanceContext PRJ_CALLBACK_DATA при вызове процедур обратного вызова поставщика.

[in, optional] options

Необязательный указатель на PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

При успешном выполнении возвращает непрозрачный дескриптор экземпляру виртуализации ProjFS. Поставщик передает это значение при вызове функций, которым требуется PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT в качестве входных данных.

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

Ошибка HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH) указывает, что virtualizationRootPath не настроен в качестве корневого каталога виртуализации.

Требования

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

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