Struct InitializationFailure 

pub struct InitializationFailure { /* private fields */ }

Retains a created handle and its library when automatic rollback is impossible. The native object still needs explicit cleanup; dropping this error performs no destruction. Keep its parent and original allocator callback state alive.

Implementations

impl InitializationFailure

pub fn handle(&self) -> CreatedHandle

Native object retained by this failure. Do not create duplicate owners.

pub fn missing_command(&self) -> &'static str

Required command whose absence prevented wrapper initialization.

pub unsafe fn destroy( self, allocator: Option<&AllocationCallbacks>, ) -> Result<(), Self>

Retry explicit cleanup; on failure return the same owner for further recovery. No submission or wait is performed.

Safety

The native object and its parents must still be live, with no children or outstanding operations. Callbacks must match creation and remain valid. Do not separately destroy the exposed handle before calling this method.

Trait Implementations

impl Debug for InitializationFailure

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

Formats the value using the given formatter.

impl Display for InitializationFailure

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

Formats the value using the given formatter.

impl Error for InitializationFailure

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 PartialEq for InitializationFailure

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.