Enum WindowsCloudFilesError 

pub enum WindowsCloudFilesError {
    FileIdentityTooLarge {
        actual: usize,
        maximum: usize,
    },
    SyncRootIdentityTooLarge {
        actual: usize,
        maximum: usize,
    },
    InvalidFileIdentity {
        reason: &'static str,
    },
    InvalidSyncRootIdentity {
        reason: &'static str,
    },
    Core(CloudFilesCoreError),
    IdentityItemMismatch,
    RootFileIdentityScopeMismatch,
    InvalidRegistrationString {
        field: &'static str,
        reason: &'static str,
    },
    EmptyProviderId,
    InvalidSyncRootPolicy {
        reason: &'static str,
    },
    UnsupportedPlatformIntegration {
        feature: &'static str,
        required: u32,
        actual: u32,
    },
    InvalidSyncRootPath {
        reason: &'static str,
    },
    NativeStructureSizeOverflow {
        structure: &'static str,
    },
    InvalidPlaceholderName {
        reason: &'static str,
    },
    InvalidPlaceholderMetadata {
        reason: &'static str,
    },
    FileSizeTooLarge {
        size: u64,
    },
    EmbeddedNul,
    PlaceholderBatchTooLarge,
    InvalidCallbackSnapshot {
        reason: &'static str,
    },
    MissingNativeCompletionAuthority,
    InvalidFetchTransfer {
        reason: &'static str,
    },
    Hydration(HydrationError),
    StaleConnectionGeneration {
        expected: u64,
        actual: u64,
    },
    ConnectionNotAccepting {
        state: SessionState,
    },
    InvalidConnectionTransition {
        from: SessionState,
        to: SessionState,
    },
    ActiveCallbackCountOverflow,
    ActiveFetchWaiterIdOverflow,
    ActiveFetchWaiterCountOverflow,
    InvalidProviderProgress {
        reason: &'static str,
    },
    InvalidWatchdogTimeout {
        reason: &'static str,
    },
    FetchDataWatchdogTimeout,
}

Product-neutral classifications for Windows-specific mapping and native-call failures.

Variants

FileIdentityTooLarge

The encoded CFAPI file identity exceeded the documented 4 KiB boundary.

Fields

actual: usize

Encoded byte length.

maximum: usize

Maximum accepted byte length.

SyncRootIdentityTooLarge

The encoded sync-root identity exceeded the documented 64 KiB boundary.

Fields

actual: usize

Encoded byte length.

maximum: usize

Maximum accepted byte length.

InvalidFileIdentity

An encoded identity envelope was malformed or used an unsupported format version.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

InvalidSyncRootIdentity

An encoded sync-root identity envelope was malformed or unsupported.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

Core(CloudFilesCoreError)

A product-neutral Forge cloud-files value or hydration contract was invalid.

IdentityItemMismatch

The supplied identity described another item.

RootFileIdentityScopeMismatch

The required root file identity belonged to another namespace/root scope.

InvalidRegistrationString

A provider-facing registration string violated the CFAPI contract.

Fields

field: &'static str

Registration field name.

reason: &'static str

Stable reason suitable for logs and tests.

EmptyProviderId

A zero provider GUID would delegate identity generation to display text.

InvalidSyncRootPolicy

Hydration or registration policies contradicted each other.

Fields

reason: &'static str

Stable policy conflict reason.

UnsupportedPlatformIntegration

A requested policy needs a newer CFAPI platform integration level.

Fields

feature: &'static str

Feature or policy requiring the newer integration.

required: u32

Minimum integration number.

actual: u32

Detected integration number.

InvalidSyncRootPath

The sync-root path was empty or otherwise unsuitable for registration.

Fields

reason: &'static str

Stable path validation reason.

NativeStructureSizeOverflow

A windows-rs native structure size could not fit the CFAPI u32 field.

Fields

structure: &'static str

Native structure name.

InvalidPlaceholderName

A Windows placeholder name was not a valid single path component.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

InvalidPlaceholderMetadata

Core item metadata could not be represented as a Windows placeholder.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

FileSizeTooLarge

A file size could not be represented by the signed CFAPI metadata field.

Fields

size: u64

Unsigned core file size.

EmbeddedNul

A Windows path contained an embedded NUL and therefore could not become a wide C string.

PlaceholderBatchTooLarge

A placeholder batch exceeded the count representable by CFAPI.

InvalidCallbackSnapshot

A callback snapshot contained malformed scalar, range, identity, or owned-string data.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

MissingNativeCompletionAuthority

A detached callback request was asked to perform a native CFAPI terminal operation.

InvalidFetchTransfer

Hydrated bytes could not be represented as one valid CFAPI transfer operation.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

Hydration(HydrationError)

Product-neutral hydration coordination or backend work failed.

StaleConnectionGeneration

A callback or completion belonged to another platform session generation.

Fields

expected: u64

Generation owned by the active connection.

actual: u64

Generation captured by the callback or completion.

ConnectionNotAccepting

The active connection lifecycle rejected a new callback.

Fields

state: SessionState

Current product-neutral session state.

InvalidConnectionTransition

The requested connection lifecycle transition skipped a required state.

Fields

from: SessionState

Current product-neutral session state.

to: SessionState

Requested product-neutral session state.

ActiveCallbackCountOverflow

The active callback counter exceeded the host address space.

ActiveFetchWaiterIdOverflow

The process-local active hydration waiter identity space was exhausted.

ActiveFetchWaiterCountOverflow

The active hydration waiter counter exceeded the host address space.

InvalidProviderProgress

A CFAPI progress value was outside the representable or monotonic range.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

InvalidWatchdogTimeout

The CFAPI callback watchdog configuration was not a usable positive duration.

Fields

reason: &'static str

Stable adapter-level reason suitable for logs and tests.

FetchDataWatchdogTimeout

A pending fetch exceeded the local watchdog deadline.

Trait Implementations

impl Debug for WindowsCloudFilesError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for WindowsCloudFilesError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for WindowsCloudFilesError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<CloudFilesCoreError> for WindowsCloudFilesError

fn from(source: CloudFilesCoreError) -> Self

Converts to this type from the input type.

impl From<HydrationError> for WindowsCloudFilesError

fn from(source: HydrationError) -> Self

Converts to this type from the input type.