Struct wmi::safearray::SafeArrayAccessor

pub struct SafeArrayAccessor<T> { /* private fields */ }

Implementations

impl<T> SafeArrayAccessor<T>

An accessor to SafeArray, which:

1. Locks the array so the data can be read.
2. Unlocks the array once dropped.

Pointers to a Safe Array can come from different places (like GetNames, WMI property value), which can have different drop behavior (GetNames require the caller to deallocate the array, while a WMI property must be deallocated via VariantClear).

For this reason, we don’t have a struct SafeArray.

However, accessing the data of the array must be done using a lock, which is the responsibility of this struct.

pub unsafe fn new(arr: *mut SAFEARRAY) -> Result<Self, WMIError>

Creates a new Accessor, locking the given array,

Safety

This function is unsafe as it is the caller’s responsibility to verify that the array is of items of type T.

pub fn as_slice(&self) -> &[T]

Return a slice which can access the data of the array.

Trait Implementations

impl<T: Debug> Debug for SafeArrayAccessor<T>

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

Formats the value using the given formatter.

impl<T> Drop for SafeArrayAccessor<T>

fn drop(&mut self)

Executes the destructor for this type.