Merge pull request #43 from erikma/dev/erikmav/exceptionDoc

Add search bait for dealing with exception under .NET Core

Author: cgallred

README.md

@@ -68,6 +68,18 @@ you can run SimpleProviderManaged.exe or a provider of your own devising.  Refer
 [this page](https://docs.microsoft.com/en-us/windows/desktop/projfs/enabling-windows-projected-file-system)
 for instructions.
 
+### Dealing with a BadImageFormatException at run time under .NET Core
+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>
+
+
 ## Contributing
 
 For details on how to contribute to this project, see the CONTRIBUTING.md file in this repository.

scripts/BuildProjFS-Managed.bat

@@ -20,7 +20,7 @@ IF NOT EXIST %nuget% (
 :: Use vswhere to find the latest VS installation (including prerelease installations) with the msbuild component.
 :: See https://github.com/Microsoft/vswhere/wiki/Find-MSBuild
 SET vswherever=2.8.4
-%nuget% install vswhere -Version %vswherever% || exit /b 1
+%nuget% install vswhere -Version %vswherever% -OutputDirectory %PROJFS_PACKAGESDIR% || exit /b 1
 SET vswhere=%PROJFS_PACKAGESDIR%\vswhere.%vswherever%\tools\vswhere.exe
 set WINSDK_BUILD=18362
 echo Checking for VS installation: