Struct UploadError 

pub struct UploadError {
    pub source: Error,
    pub partial: Option<ObjectHandle>,
}

Error from an upload, carrying the handle of the object the device created during SendObjectInfo before the data phase failed.

PTP uploads are two-phase: SendObjectInfo creates the object on the device (returning a handle), then SendObject streams the bytes. If the data phase fails or is cancelled, the device is left holding a partial (often empty or truncated) object. This error surfaces that handle so the caller owns the cleanup-or-resume decision, rather than the library guessing.

The library does not auto-delete the partial object: deleting it would issue hidden USB I/O to a possibly-disconnected device, the leave-vs-delete behavior is device-dependent, and PTP’s two-phase model is designed so a failed SendObject can be retried against the same handle (resume).

[From<UploadError> for Error] keeps ? ergonomic for callers working in an Error context; they drop the partial handle unless they match on UploadError explicitly.

Fields

source: Error

The underlying failure (I/O, protocol, cancellation, timeout, …).

partial: Option<ObjectHandle>

The handle of the partially-written object the device may still hold.

Some iff SendObjectInfo succeeded but the data phase did not complete (genuine error OR cancellation). The object may be empty or truncated. The caller decides: delete it (for example, Storage::delete) to discard the corrupt artifact, or retry the data phase to resume.

None iff no object was created (for example, SendObjectInfo itself failed because the storage is read-only or the parent is invalid).

Trait Implementations

impl Debug for UploadError

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

Formats the value using the given formatter.

impl Display for UploadError

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

Formats the value using the given formatter.

impl Error for UploadError

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<UploadError> for Error

fn from(e: UploadError) -> Self

Converts to this type from the input type.