Compartir a través de

Función PrjStartVirtualizing (projectedfslib.h)

  • Artículo

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.

Sintaxis

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 a 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 hacerse 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 raíz de virtualización.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado projectedfslib.h