Struct RemotePointer 

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

A safe wrapper around a pointer allocated by COM.

This struct ensures proper cleanup of COM-allocated memory when dropped. It provides methods to access the underlying pointer.

Implementations

impl<T: Sized> RemotePointer<T>

pub fn null() -> Self

Creates a new RemotePointer initialized to null.

pub fn as_mut_ptr(&mut self) -> *mut *mut T

pub fn as_ref(&self) -> Option<&T>

Returns an Option referencing the inner value if it is not null.

Safety

The caller must ensure that the inner pointer is valid for reads.

pub fn ok(&self) -> Result<&T>

pub fn from_option<R: Into<RemotePointer<T>>>(value: Option<R>) -> Self

impl RemotePointer<u16>

pub fn as_mut_pwstr_ptr(&mut self) -> *mut PWSTR

Returns a mutable pointer to a PWSTR.

Trait Implementations

impl<T: Clone + Sized> Clone for RemotePointer<T>

fn clone(&self) -> RemotePointer<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Sized> Debug for RemotePointer<T>

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

Formats the value using the given formatter.

impl<T: Sized> Default for RemotePointer<T>

fn default() -> Self

Creates a new RemotePointer initialized to null by default.

impl<T: Sized> Drop for RemotePointer<T>

fn drop(&mut self)

Drops the RemotePointer, freeing the COM-allocated memory.

impl From<&str> for RemotePointer<u16>

fn from(value: &str) -> Self

Converts a string slice to a RemotePointer<u16>.

impl From<PWSTR> for RemotePointer<u16>

fn from(value: PWSTR) -> Self

Converts a PWSTR to a RemotePointer<u16>.

impl<T: PartialEq + Sized> PartialEq for RemotePointer<T>

fn eq(&self, other: &RemotePointer<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<RemotePointer<u16>> for Option<String>

fn try_from(value: RemotePointer<u16>) -> Result<Self, Self::Error>

Attempts to convert a RemotePointer<u16> to an Option<String>.

Errors

Returns an error if the string conversion fails.

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<RemotePointer<u16>> for String

fn try_from(value: RemotePointer<u16>) -> Result<Self, Self::Error>

Attempts to convert a RemotePointer<u16> to a String.

Errors

Returns an error if the pointer is null or if the string conversion fails.

type Error = Error

The type returned in the event of a conversion error.

impl<T: Sized> StructuralPartialEq for RemotePointer<T>