Struct RtlHeapBox 

pub struct RtlHeapBox<T: ?Sized> { /* private fields */ }

A wrapper around memory that was allocated with RtlAllocateHeap and will be freed on drop with RtlFreeHeap, like std::boxed::Box.

Implementations

impl<T> RtlHeapBox<T>

pub unsafe fn from_raw(value: *mut T) -> Self

Creates a new RtlHeapBox from a raw pointer.

Safety

The caller must guarantee that the pointer was allocated with RtlAllocateHeap with the default heap of the current process as the heap handle, returned by GetProcessHeap.

The caller must not allow this pointer to be aliased anywhere else. Conceptually, by calling from_raw, the caller must guarantee that ownership of the pointer value is transferred to this RtlHeapBox. This is to uphold the aliasing requirements used by RtlHeapBox to implement various Deref and AsRef traits.

On drop, this memory will be freed with RtlFreeHeap. The caller must not manually free this pointer.

pub fn as_ptr(&self) -> *const T

Gets the contained pointer.

Trait Implementations

impl<T> AsMut<T> for RtlHeapBox<T>

fn as_mut(&mut self) -> &mut T

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T> AsRef<T> for RtlHeapBox<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Deref for RtlHeapBox<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for RtlHeapBox<T>

fn deref_mut(&mut self) -> &mut T

Mutably dereferences the value.

impl<T: ?Sized> Drop for RtlHeapBox<T>

fn drop(&mut self)

Executes the destructor for this type.