Función PrjStartVirtualizing (projectedfslib.h)

Configura una instancia de virtualización de ProjFS y la inicia, lo que hace que esté disponible para la E/S del servicio e invoque devoluciones de llamada en el proveedor.

Syntax

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

Parámetros

[in] virtualizationRootPath

Puntero a una cadena unicode terminada en null que especifica la ruta de acceso completa al directorio raíz de virtualización.

El proveedor debe haber llamado PrjMarkDirectoryAsPlaceholder pasando la ruta de acceso especificada como el parámetro rootPathName y NULL como el parámetro targetPathName antes de llamar a esta rutina. Esto solo debe realizarse una vez para designar la ruta de acceso como directorio raíz de virtualización

[in] callbacks

Puntero a una estructura de PRJ_CALLBACKS que se ha rellenado con punteros a las funciones de devolución de llamada del proveedor.

[in, optional] instanceContext

Puntero a la información de contexto definida por el proveedor para cada instancia. Este parámetro es opcional y puede ser NULL. Si se especifica, ProjFS lo devolverá en el miembro InstanceContext de PRJ_CALLBACK_DATA al invocar rutinas de devolución de llamada del proveedor.

[in, optional] options

Puntero opcional a un PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

Si se ejecuta correctamente, devuelve un identificador opaco a la instancia de virtualización de ProjFS. El proveedor pasa este valor al llamar a funciones que requieren un PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT como entrada.

Valor devuelto

El error, HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH), indica que virtualizationRootPath no se ha configurado como una raíz de virtualización.

Requisitos