PlayerSupportPackCatalog.Acquire
Section titled “PlayerSupportPackCatalog.Acquire”
- Resolves one installed Support Pack after validating its deployment-only closure.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build
Declaration
Section titled “Declaration”public Inno.Build.PlayerSupportPackLease Inno.Build.PlayerSupportPackCatalog.Acquire(Inno.Build.BuildTargetId target, Inno.Build.IPlayerSupportPackValidator validator, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter target: The platform and architecture identity of the required Support Pack.
Parameter validator: The target-owned validator for runtime or linker inputs.
Parameter cancellationToken: Cancels ownership acquisition or complete content validation before returning a lease.
Returns
Section titled “Returns”Reading ownership of the complete pack; dispose it after its final consumer finishes.
Exceptions
Section titled “Exceptions”Exception T:System.IO.DirectoryNotFoundException: Thrown when no Support Pack is installed for target.
Exception T:System.IO.InvalidDataException: Thrown when the pack is empty, contains build-time payload, or lacks its Player executable or native runtimes.
Exception T:System.OperationCanceledException: Acquisition or validation was canceled; no reading ownership is transferred.
Exception T:System.TimeoutException: Exclusive repair or retirement retains the artifact for more than thirty seconds.