From f8749f8e438b150884449ad3e2e13aed750de679 Mon Sep 17 00:00:00 2001
From: Rob Mensching <rob@firegiant.com>
Date: Fri, 4 Nov 2022 01:05:28 -0700
Subject: Provide useful error message when file system operations fail

Fixes 5417
---
 .../wix/WixToolset.Extensibility/Services/IFileSystem.cs    | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

(limited to 'src/api')

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
-- 
cgit v1.2.3-55-g6feb