Skip to content
API referenceDevelopmentEngine APIEngine ccf7d03f
Synced

BuildCachePublisher.EnsureImmutableRegistration

Section titled “BuildCachePublisher.EnsureImmutableRegistration”
  • Establishes an immutable artifact’s ownership once, or confirms its unchanged registration without rewriting it.

API: engine
Project: Inno.Build.Toolchains

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))

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.

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.

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.