BuildCachePublisher.EnsureImmutableRegistration
Section titled “BuildCachePublisher.EnsureImmutableRegistration”
- Establishes an immutable artifact’s ownership once, or confirms its unchanged registration without rewriting it.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public void Inno.Build.Toolchains.BuildCachePublisher.EnsureImmutableRegistration(string directory, string leasePath, System.Collections.Generic.IReadOnlyList<string> dependencies, string? targetId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter directory: The completed artifact within this publisher’s exact boundary.
Parameter leasePath: The persistent artifact lease held by the caller alongside this publisher’s activity lease.
Parameter dependencies: The exact dependency closure, in its original publication order.
Parameter targetId: The producer’s explicit target, or null for shared host work.
Parameter cancellationToken: Cancels inspection or initial registration before publication.
Remarks
Section titled “Remarks”This confirms ownership, not content integrity. The producer must verify the immutable payload itself. Existing registration age is retained; use an active lease or a current generation dependency to protect consumers. This operation neither selects a current root nor records a new use time.
Exceptions
Section titled “Exceptions”Exception T:System.InvalidOperationException: This publisher does not own immutable artifacts.
Exception T:System.IO.IOException: Paths cross ownership boundaries or links, or payload files are unavailable.
Exception T:System.IO.InvalidDataException: Existing ownership metadata disagrees with the immutable publication.
Exception T:System.OperationCanceledException: Inspection or registration was canceled.