IDesktopFileLauncher interface

Namespace Runic.Platform · Runic.Platform 0.7.0-preview.5

public interface IDesktopFileLauncher

Native file handoff. Paths are supplied by trusted C# application code, never directly by a web client.

Methods

LaunchAsync

ValueTask<PlatformResult<PlatformUnit>> LaunchAsync(string path, DesktopFileOperation operation = DesktopFileOperation.Open, CancellationToken cancellationToken = default)

The caller must retain any sandbox/security-scoped access until the operation completes.

Remarks

Success acknowledges native handling, not that another application opened the file. Windows Open With can report success even when dismissed; UserDismissed is returned only when the native API distinguishes dismissal. Windows and macOS Open returns PermissionDenied for programs, scripts, installers and shortcuts instead of running them; Linux applies the desktop portal's policy. Windows rejects UNC, device and alternate-stream paths.