Branch	Functional Tests
master
release

ProjFS is short for Windows Projected File System. ProjFS allows a user-mode application called a "provider" to project hierarchical data into the file system, making it appear as files and directories in the file system. For example, a simple provider could project the Windows registry into the file system, making registry keys and values appear as files and directories, respectively. An example of a more complex provider is VFS for Git, used to virtualize very large git repos.

Conceptual documentation for ProjFS along with documentation of its Win32 API is at docs.microsoft.com.

ProjFS ships as an optional component starting in Windows 10 version 1809.

The Windows SDK contains a native C API for ProjFS. The ProjFS Managed API provides a wrapper around the native API so that developers can write ProjFS providers using managed code.

This project contains the code that builds the API wrapper, ProjectedFSLib.Managed.dll. It is in the ProjectedFSLib.Managed.API directory.

This project builds a simple ProjFS provider, SimpleProviderManaged.exe, that uses the managed API. It projects the contents of one directory (the "source") into another one (the "virtualization root").

This project builds an NUnit test, ProjectedFSLib.Managed.Test.exe, that uses the SimpleProviderManaged provider to exercise the API wrapper. The managed API is a fairly thin wrapper around the native API, and the native API has its own much more comprehensive tests that are routinely executed at Microsoft in the normal course of OS development. So this managed test is just a basic functional test to get coverage of the managed wrapper API surface.

• Install Visual Studio 2019 Community Edition version 16.4 or higher.
  • Include the following workloads:
    • .NET desktop development
    • .NET Core cross-platform development
    • Desktop development with C++
  • Include the following individual components:
    • .NET Framework 4.6.1 SDK
    • C++/CLI support
    • Windows 10 SDK (10.0.18362.0)
• Create a folder to clone into, e.g. C:\Repos\ProjFS-Managed
• Clone this repo into the src subfolder, e.g. C:\Repos\ProjFS-Managed\src
• Run src\scripts\BuildProjFS-Managed.bat
  • You can also build in Visual Studio by opening src\ProjectedFSLib.Managed.sln and building.

The build outputs will be placed under a BuildOutput subfolder, e.g. C:\Repos\ProjFS-Managed\BuildOutput.

Note: The Windows Projected File System optional component must be enabled in Windows before you can run SimpleProviderManaged.exe or a provider of your own devising. Refer to this page for instructions.

If you encounter this exception pattern at runtime when using this package under .NET Core:

System.BadImageFormatException: Could not load file or assembly 'ProjectedFSLib.Managed, Version=1.2.19351.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35'. An attempt was made to load a program with an incorrect format.

This typically occurs when the .NET Core loader attempts to find Ijwhost.dll from the .NET Core runtime. To force this to be deployed with your application under MSBuild, add the following property to each csproj file that is importing the Microsoft.Windows.ProjFS package:

<PropertyGroup>
  <UseIJWHost>True</UseIJWHost>
</PropertyGroup>

For details on how to contribute to this project, see the CONTRIBUTING.md file in this repository.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.