Synced
BuildArtifactWriteLease.AcquireAsync
Section titled “BuildArtifactWriteLease.AcquireAsync”
- Waits for all readers before allowing mutation of one immutable artifact directory.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static System.Threading.Tasks.ValueTask<Inno.Build.Toolchains.BuildArtifactWriteLease> Inno.Build.Toolchains.BuildArtifactWriteLease.AcquireAsync(string directory, string ownerDirectory, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter ownerDirectory: The exact publisher root retaining the persistent owner.lock gate.
Parameter directory: The absolute artifact location controlled by the publisher.
Parameter cancellationToken: Cancels this waiter without disturbing existing readers.
Returns
Section titled “Returns”Exclusive protection; retain it through replacement and release it before acquiring a reading lease.
Exceptions
Section titled “Exceptions”Exception T:System.ArgumentException: The directory is empty or relative.
Exception T:System.TimeoutException: Other owners retain the artifact for more than thirty seconds.
Exception T:System.OperationCanceledException: Waiting was canceled.