WindowsPathPersistentAccessBackend class final

Windows persistent access backed by versioned normalized filesystem paths.

Windows desktop applications do not require the macOS security-scoped bookmark lifecycle. Missing paths are treated as temporarily unavailable so removable and network drives can be retried later. Legacy handles containing only an absolute path remain readable.

Successful recovery proves only that the path exists with the expected entity kind. It does not guarantee that a later read or write will succeed.

Inheritance

• Object
• PersistentAccessBackend
• WindowsPathPersistentAccessBackend

Constructors

WindowsPathPersistentAccessBackend({bool caseSensitivePaths = false})

const

Properties

caseSensitivePaths → bool

Whether path identities preserve letter case.

final

handlesFollowMoves → bool

Whether an available handle can follow its entity to a new identity.

no setter, inherited

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

createHandle(FileSystemEntity entity) → Future<String>

Creates an opaque persistent handle for an authorized entity.

override

describeHandle(String handle) → PersistentAccessHandleDescription

Returns metadata encoded in handle without resolving filesystem access.

override

descriptionIdentity(PersistentAccessHandleDescription description) → String?

Returns a stable identity for metadata recovered from a stored handle.

override

entityIdentity(FileSystemEntity entity) → String

Returns a stable identity used to reject duplicate entities.

override

isInvalidHandleError(Object error) → bool

Whether error proves that the serialized handle is permanently invalid.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

withHandleAccess<T>(String handle, FutureOr<T> operation(FileSystemEntity entity)) → Future<T>

Runs operation with access to the file or directory stored by handle.

override

Operators

operator ==(Object other) → bool

The equality operator.

inherited