Trait IBinder

Source

pub trait IBinder:
    Any
    + Send
    + Sync {
    // Required methods
    fn link_to_death(&self, recipient: Weak<dyn DeathRecipient>) -> Result<()>;
    fn unlink_to_death(&self, recipient: Weak<dyn DeathRecipient>) -> Result<()>;
    fn ping_binder(&self) -> Result<()>;
    fn as_any(&self) -> &dyn Any;
    fn as_transactable(&self) -> Option<&dyn Transactable>;
    fn descriptor(&self) -> &str;
    fn is_remote(&self) -> bool;
    fn inc_strong(&self, strong: &SIBinder) -> Result<()>;
    fn attempt_inc_strong(&self) -> bool;
    fn dec_strong(&self, strong: Option<ManuallyDrop<SIBinder>>) -> Result<()>;
    fn inc_weak(&self, weak: &WIBinder) -> Result<()>;
    fn dec_weak(&self) -> Result<()>;
}

Expand description

Interface of binder local or remote objects.

This trait corresponds to the parts of the interface of the C++ IBinder class which are public.

Required Methods§

Source

fn link_to_death(&self, recipient: Weak<dyn DeathRecipient>) -> Result<()>

Register the recipient for a notification if this binder goes away. If this binder object unexpectedly goes away (typically because its hosting process has been killed), then the DeathRecipient’s callback will be called.

You will only receive death notifications for remote binders, as local binders by definition can’t die without you dying as well. Trying to use this function on a local binder will result in an INVALID_OPERATION code being returned and nothing happening.

This link always holds a weak reference to its recipient.

Source