virtualbox_rs 0.4.2

A Rust library for interacting with VirtualBox, providing a safe and idiomatic interface to the VirtualBox API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

use crate::utility::macros::macros::call_function;
use crate::VboxError;
use log::{debug, error};
use vbox_raw::sys_lib::IToken;

pub mod implementation;
/// The Token interface represents a token passed to an API client, which triggers cleanup actions when it is explicitly released by calling the abandon method (preferred, as it is accurately defined when the release happens), or when the object reference count drops to 0.
///
/// **Reference to the official documentation:**
///
/// [https://www.virtualbox.org/sdkref/interface_i_token.html](https://www.virtualbox.org/sdkref/interface_i_token.html)
#[derive(Debug)]
pub struct Token {
    object: *mut IToken,
}

impl Token {
    pub(crate) fn new(object: *mut IToken) -> Self {
        Self { object }
    }

    fn release(&self) -> Result<i32, VboxError> {
        call_function!(self.object, Release)
    }
}

impl Drop for Token {
    fn drop(&mut self) {
        match self.release() {
            Ok(count) => {
                debug!("Token refcount: {}", count)
            }
            Err(err) => {
                error!("Failed drop Token. Error: {:?}", err)
            }
        }
    }
}