NativeInputMaterializer.CopyAsync
Section titled “NativeInputMaterializer.CopyAsync”
- Copies a declared input atomically when its destination differs, preserving identical file timestamps.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static System.Threading.Tasks.ValueTask<bool> Inno.Build.Toolchains.NativeInputMaterializer.CopyAsync(Inno.Build.Toolchains.NativeBuildContext context, string source, string destination, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter context: The operation whose initial source bytes and hashing statistics are shared across components.
Parameter source: The absolute input file already declared by the component recipe.
Parameter destination: The absolute intermediate file owned exclusively by the component producer.
Parameter cancellationToken: Cancels copying before publication and preserves the prior intermediate file.
Returns
Section titled “Returns”True when bytes were copied and published; false when the existing content was identical.
Exceptions
Section titled “Exceptions”Exception T:System.InvalidOperationException: The source changes relative to the operation’s frozen input snapshot.
Exception T:System.IO.IOException: The source, destination or atomic candidate cannot be read or published.