Crate aster_forge_cloud_files_windows

Expand description

Windows Cloud Files bindings for the product-neutral Forge cloud-files core.

This crate owns CFAPI-specific item/sync-root identity encoding, placeholder metadata, filename validation, persistent registration policies, active connection/session fencing, owned FETCH_DATA/CANCEL_FETCH_DATA snapshots, bounded callback ingress, active hydration waiter cancellation, and native calls. Product authentication, remote DTOs, account policy, persistence adapters, and user-visible error mapping remain in product crates.

Structs§

WindowsCallbackInfoSnapshot: Owned common data copied from CF_CALLBACK_INFO before the callback returns.
WindowsCallbackLease: Non-cloneable ownership proof for one callback accepted before the closing fence.
WindowsCallbackQueueMetrics: Bounded callback-ingress counters for one native connection generation.
WindowsCallbackRange: Owned CFAPI callback range preserving the native CF_EOF distinction.
WindowsCancelFetchDataFlags: Bitset copied from CF_CALLBACK_CANCEL_FLAGS.
WindowsCancelFetchDataRequest: Accepted cancellation notification plus its non-cloneable active-session lease.
WindowsCancelFetchDataSnapshot: Owned CANCEL_FETCH_DATA callback snapshot.
WindowsConnectionKey: Opaque native connection key returned by CfConnectSyncRoot.
WindowsConnectionSession: Shareable lifecycle fence for one active native connection generation.
WindowsFetchDataCancellationOutcome: Per-callback result of matching one CFAPI cancellation range to active hydration waiters.
WindowsFetchDataCorrelation: Compact scalar correlation needed by waiter lookup and CfReportProviderProgress.
WindowsFetchDataFlags: Bitset copied from CF_CALLBACK_FETCH_DATA_FLAGS.
WindowsFetchDataProgress: One provider progress sample for a pending CFAPI transfer.
WindowsFetchDataProgressReporter: Cloneable correlation handle for reporting progress while the request itself is awaiting hydration. It owns no terminal completion authority.
WindowsFetchDataRequest: Accepted hydration request plus its non-cloneable active-session lease.
WindowsFetchDataSnapshot: Owned FETCH_DATA callback snapshot.
WindowsFetchDataTransfer: Owned logical bytes ready for one synchronous CFAPI transfer call.
WindowsFetchDataWaiterMetrics: Monotonic process-local counters for active fetch waiters and cancellation matching.
WindowsFetchDataWaiterRegistry: Shareable active-waiter registry for one or more CFAPI connection generations.
WindowsFetchDataWatchdog: Deadline state for one pending fetch. The host supplies Instant values, making tests deterministic without a Tokio timer or a background thread in the native callback path.
WindowsFetchDataWatchdogConfig: Host-controlled watchdog configuration for one pending fetch.
WindowsFetchDataWatchdogOutcome: Result of one host watchdog poll.
WindowsFileIdentity: Owned, validated CFAPI file identity for one exact Forge item key.
WindowsFileTimes: Windows file times expressed as signed 100-nanosecond intervals since the Windows epoch.
WindowsHydrationPolicy: Primary hydration behavior plus independently negotiated CFAPI modifiers.
WindowsInSyncPolicy: Supported CFAPI in-sync tracking bits.
WindowsPlaceholder: Owned input for one CfCreatePlaceholders entry.
WindowsPlaceholderManagementPolicy: Permissions granted to non-provider processes while the sync root is active.
WindowsPlaceholderMetadata: Owned CFAPI filesystem metadata for one placeholder.
WindowsPlaceholderOptions: CFAPI placeholder creation options kept independent from windows-rs types.
WindowsPlatformVersion: Detected CFAPI platform version used for gated policy validation.
WindowsPreflightRequest: Accepted preflight request with exactly one native acknowledgement responsibility.
WindowsProcessInfoSnapshot: Owned process information requested through CF_CONNECT_FLAG_REQUIRE_PROCESS_INFO.
WindowsProviderId: Stable provider telemetry identity shared by every version and sync root of one provider.
WindowsRequestKey: Opaque request key used by newer CFAPI operation correlation.
WindowsRestartHydration: Product-neutral metadata replacement for one CFAPI RESTART_HYDRATION operation.
WindowsSyncRootConnectOptions: Additional callback metadata and implicit-hydration behavior requested at connect time.
WindowsSyncRootIdentity: Owned, versioned CFAPI sync-root identity for one exact Forge namespace/root scope.
WindowsSyncRootPolicies: Complete CFAPI sync-root policy set.
WindowsSyncRootRegistration: Owned persistent sync-root registration request.
WindowsSyncRootRegistrationOptions: Persistent registration flags independent from windows-rs values.
WindowsTransferKey: Opaque transfer key used by CFAPI to correlate hydration operations.

Enums§

WindowsCallbackRangeLength: CFAPI callback range length.
WindowsCallbackRequest: One immutable callback snapshot accepted by a specific connection generation.
WindowsCloudFilesError: Product-neutral classifications for Windows-specific mapping and native-call failures.
WindowsFetchDataFailure: Structured failure classifications accepted by the minimal fetch terminal path.
WindowsFetchDataPreparation: Portable outcome of waiting for one cancellation-registered CFAPI hydration request.
WindowsHardLinkPolicy: Whether placeholder hard links are permitted.
WindowsHydrationPolicyPrimary: Hydration behavior requested from CFAPI.
WindowsObservedNotification: Owned notification that CFAPI has already completed a local filesystem effect.
WindowsPopulationPolicy: Supported namespace population behavior.
WindowsPreflightSnapshot: Owned CFAPI operation that blocks a local filesystem effect until the provider acknowledges it.

Constants§

CFAPI_FILE_IDENTITY_MAX_BYTES: Maximum FileIdentity size accepted by Windows Cloud Files.
CFAPI_MAX_PRIORITY_HINT: Maximum priority value documented by CFAPI.
CFAPI_SYNC_ROOT_IDENTITY_MAX_BYTES: Maximum SyncRootIdentity size accepted by CfRegisterSyncRoot.
CFAPI_TRANSFER_ALIGNMENT_BYTES: Physical range alignment required by CFAPI transfer operations.
FILE_ATTRIBUTE_DIRECTORY: Windows directory file-attribute bit.
FILE_ATTRIBUTE_NORMAL: Windows normal-file attribute bit.
WINDOWS_CFAPI_CALLBACK_TIMEOUT: The fixed callback timeout documented by Windows CFAPI.

Type Aliases§

Result: Result type returned by the Windows cloud-files adapter.