Provide useful error message when file system operations fail

Fixes 5417

1 files changed, 9 insertions, 4 deletions

diff --git a/src/api/wix/WixToolset.Extensibility/Services/IFileSystem.cs b/src/api/wix/WixToolset.Extensibility/Services/IFileSystem.cs
index cd987555..83a44400 100644
--- a/src/api/wix/WixToolset.Extensibility/Services/IFileSystem.cs
+++ b/src/api/wix/WixToolset.Extensibility/Services/IFileSystem.cs
@@ -4,6 +4,7 @@ namespace WixToolset.Extensibility.Services
 {
     using System;
     using System.IO;
+    using WixToolset.Data;
 
     /// <summary>
     /// Abstracts basic file system operations.
@@ -13,34 +14,38 @@ namespace WixToolset.Extensibility.Services
         /// <summary>
         /// Copies a file.
         /// </summary>
+        /// <param name="sourceLineNumbers">Optional source line number requiring the copy.</param>
         /// <param name="source">The file to copy.</param>
         /// <param name="destination">The destination file.</param>
         /// <param name="allowHardlink">Allow hardlinks.</param>
-        void CopyFile(string source, string destination, bool allowHardlink);
+        void CopyFile(SourceLineNumber sourceLineNumbers, string source, string destination, bool allowHardlink);
 
         /// <summary>
         /// Deletes a file.
         /// </summary>
+        /// <param name="sourceLineNumbers">Optional source line number requiring the delete.</param>
         /// <param name="source">The file to delete.</param>
         /// <param name="throwOnError">Indicates the file must be deleted. Default is a best effort delete.</param>
         /// <param name="maxRetries">Maximum retry attempts. Default is 4.</param>
-        void DeleteFile(string source, bool throwOnError = false, int maxRetries = 4);
+        void DeleteFile(SourceLineNumber sourceLineNumbers, string source, bool throwOnError = false, int maxRetries = 4);
 
         /// <summary>
         /// Moves a file.
         /// </summary>
+        /// <param name="sourceLineNumbers">Optional source line number requiring the move.</param>
         /// <param name="source">The file to move.</param>
         /// <param name="destination">The destination file.</param>
-        void MoveFile(string source, string destination);
+        void MoveFile(SourceLineNumber sourceLineNumbers, string source, string destination);
 
         /// <summary>
         /// Opens a file.
         /// </summary>
+        /// <param name="sourceLineNumbers">Optional source line number requiring the file.</param>
         /// <param name="path">The file to open.</param>
         /// <param name="mode">A System.IO.FileMode value that specifies whether a file is created if one does not exist, and determines whether the contents of existing files are retained or overwritten.</param>
         /// <param name="access">A System.IO.FileAccess value that specifies the operations that can be performed on the file.</param>
         /// <param name="share">A System.IO.FileShare value specifying the type of access other threads have to the file.</param>
-        FileStream OpenFile(string path, FileMode mode, FileAccess access, FileShare share);
+        FileStream OpenFile(SourceLineNumber sourceLineNumbers, string path, FileMode mode, FileAccess access, FileShare share);
 
         /// <summary>
         /// Executes an action and retries on any exception a few times with short pause