Struct BridgeContext 

pub struct BridgeContext<T>
where
    T: 'static,
{ /* private fields */ }

Async operation context for bridging rust code into SF COM api that supports cancellation.

Implementations

impl<T> BridgeContext<T>

where T: Send,

pub fn make( callback: Ref<'_, IFabricAsyncOperationCallback>, ) -> (Self, BoxedCancelToken)

Creates the context from callback, and returns a cancellation token that can be used in rust code, and the cancellation token is hooked into self, where Cancel() api cancels the operation.

pub fn spawn<F>( self, rt: &impl Executor, future: F, ) -> WinResult<IFabricAsyncOperationContext>

where F: Future<Output = T> + Send + 'static,

Spawns the future on rt. Returns a context that can be returned to SF runtime. This is intended to be used in SF Begin COM api, where rust code is spawned in background and the context is returned to caller. If the future panics, an error is set in the resulting content, caller will still get callback and receive an error in the End api. This api is in some sense unsafe, because the developer needs to ensure the following:

• return type of the future needs to match SF COM api end return type.

pub fn result(context: Ref<'_, IFabricAsyncOperationContext>) -> Result<T>

Get the result from the context from the SF End COM api. This api is in some sense unsafe, because the developer needs to ensure the following:

• context impl type is BridgeContext3, and the T matches the SF end api return type.

Note that if T is of Result type, the current function return type is Result<Result>, so unwrap is needed.

Trait Implementations

impl<T> AsImpl<BridgeContext<T>> for IFabricAsyncOperationContext

where T: 'static,

unsafe fn as_impl_ptr(&self) -> NonNull<BridgeContext<T>>

Returns a pointer to the implementation object.

unsafe fn as_impl(&self) -> &T

Safety

impl<T> ComObjectInner for BridgeContext<T>

where T: 'static,

type Outer = BridgeContext_Impl<T>

The generated <foo>_Impl type (aka the “boxed” type or “outer” type).

fn into_object(self) -> ComObject<Self>

Moves an instance of this type into a new ComObject box and returns it.

impl<T> From<BridgeContext<T>> for IFabricAsyncOperationContext

where T: 'static,

fn from(this: BridgeContext<T>) -> Self

Converts to this type from the input type.

impl<T> From<BridgeContext<T>> for IInspectable

where T: 'static,

fn from(this: BridgeContext<T>) -> Self

Converts to this type from the input type.

impl<T> From<BridgeContext<T>> for IUnknown

where T: 'static,

fn from(this: BridgeContext<T>) -> Self

Converts to this type from the input type.