WindowsShellLinkClient class

Namespace Runic.Platform.Administration.Windows.Shortcuts · Runic.Platform.Administration.Windows 0.7.0-preview.5

public sealed class WindowsShellLinkClient : IWindowsShellLinkClient

Inherits or implements IWindowsShellLinkClient.

Local shell-link operations, executed on an owned COM apartment without a desktop owner.

Constructors

WindowsShellLinkClient

public WindowsShellLinkClient()

No documentation.

Methods

CreateAsync

public Task CreateAsync(string path, ShellLinkSpecification specification, bool replaceExisting = false, CancellationToken cancellationToken = default)

Creates a link; replacement requires explicit opt-in. A failed staged save retains the destination.

FindAsync

public Task<ShellLinkSnapshot?> FindAsync(string path, CancellationToken cancellationToken = default)

Reads without resolving or displaying UI. Returns null only if the link or its directory is absent.

ResolveAsync

public Task<ShellLinkSnapshot> ResolveAsync(string path, TimeSpan timeout, CancellationToken cancellationToken = default)

Explicitly resolves a target without UI or writing the source link. The timeout is passed to the shell.

Remarks

The shell timeout limits its no-UI resolution work; it cannot guarantee a hard deadline for every network provider.

UpdateAsync

public Task UpdateAsync(string path, ShellLinkUpdate update, CancellationToken cancellationToken = default)

Updates only supplied fields, retaining other shell-link metadata. Missing links are errors.